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Sixth Edition (December 1975) 

ITiis is a major revision of, and obsoletes, SC2 1-7507-4 and Technical Newsletters 
SN21-7738, SN21-7759, and SN21-5255. Information for the Model 12 RPG II 
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left of the figure title. Appendix I has been added and should be reviewed in its entirety. 
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This revision remains in effect for all subsequent versions and modifications unless 
specifically altered by a new edition or a technical newsletter. Changes are 
continually made to the specifications herein; before using this publication in 
connection with the operation of IBM systems, consult the latest IBM System/3 
Bibliography. GC20-8080, for the editions that are applicable and current. 

Use this publication only for the purposes stated in the Preface. 

Publications are not stocked at the address below. Requests for copies of IBM 
publications and for technical information about the system should be made to 
your IBM representative or to the IBM branch office serving your locality. 

This publication could contain technical inaccuracies or typographical errors. Use 
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Corporation, Publications, Department 245, Rochester, Minnesota 55901. Comments 
become the property of IBM. 

©Copyright International Business Machines Corporation 1969, 1970, 1971, 1972, 1973, 1975 
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Preface 



This reference manual is intended primarily for the Systeni/3 
user who has little or no experience with telecommunications 
programming. 

This manual provides information a programmer needs to 
write System/3 PIPG il telecommunications programs. 
It contains a: 

• Definition of basic telecommunications terms 

• Statement of the telecommunications capabilities of 
System/3 



IBM SYSTEM/3 5448 DISK STORAGE DRIVE 

The IBM System/3 5448 Disk Storage Drive on System/3 
Models 8 and 10 uses the same program product support 
as the IBM 5445 Disk Storage. However, a separate 
system control program feature is required for the 5448. 
In general, references to 5445 in this manual also apply 
to 5448. For specific information about 5448 operating 
characteristics and progrannning support, see IBM 
System/ 3 5448 Disk Storage Drive Program Reference 
Manual, GC21-5168. 



• Description of each of the RPG Telecommunications 
Specifications required to write a telecommunications 
program for System/3 

Sample programs are included in this manual to illustrate 
programming techniques and possible applications for 
System/3 RPG II telecommunications programming. 



System/3 Model 8 

The System/3 Model 8 is supported by System/3 Model 10 
Disk System control programming and program products. 
The i'acilities described in this publication for the Model 10 
are also applicable to the Model 8, althougli the Model 8 is 
not referenced. However, the Integrated Communications 
Adapter (ICA) is available only on the Model 8. If you have 
the ICA, it is always designated as BSCA line 2. Therefore, 
you must enter the BSCA OCL statement (// BSCA LINE-2) 
at execution time. It should be noted that not all devices 
and features which are available on the Model 10 are 
available on the Model 8. Therefore, Model 8 users should 
be familiar with the contents of IBM System/ 3 Model 8 
Introduction, GC21-5! 14. 
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Related Publications 
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ACKO 


Even positive acicnowledge 


ACKl 


Odd positive acknowledge 


ASCII 


American national standard code for informa- 




tion interchange 
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Block check count 
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Bits per second 


BSC 


Binary synchronous communications 
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Binary synchronous communications adapter 
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Basic telecommunications access method 




(System/370) 


DA 


Display adapter 
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Disconnect 
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Disk operating system 


EBCDIC 
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code 
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ENQ 
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End of text block character 
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End of text character 



RVI Reverse interrupt character 
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Introduction 



IBM System/3 Telecommunications programming provides 
the user with the capabihty of sending and receiving binary 
synchronous data over common carrier faciHties. The pro- 
gramming performs all functions necessary to estabhsh line 
connections, exchange identification sequences, send and 
receive data, and execute the correct termination or discon- 
nect procedures. 

System/3 RPG II telecommunications support is provided 
via the RPG II language. Binary synchronous data trans- 
mission is possible between System/3 and: 

• Other System/3s. 

• Operating System or Disk Operating System Basic Tele- 
communications Access Method Binary Synchronous 
Communications (OS or DOS BTAM BSC). 

• System/360 Model 20 Input Output Control System for 
the Binary Synchronous Communications Adapter. 

• Operating System Telecommunications Access Method 
(TCAM). 

• IBM 3741 Model 2 Data Station. 

• IBM 5230 Model 2 Data CoOection Controller. 

• IBM 3750 Switching System (World Trade only). 

• IBM System/7. 



The System/3 Model 10 Disk System, Model 12, Model 6, 
Model 8, and Model 15 can also transmit data to and receive 
data from the IBM 2770 Data Communication System and 
the IBM 2780 Data Transmission Terminal (see Appendix H). 

BSCA files are defined by entries on the RPG File Descrip- 
tion Specification and the RPG Telecommunications Speci- 
fication. 

Note: For use of the second BSCA feature, see the IBM 
System! 3 Model 10 Disk System Control Programming 
Reference Manual, GC2 1-7512, IBM System/ 3 Model 12 
System Control Programming Reference Manual, 
I GC2 1 -5 1 30, or IBM System/ 3 Model 15 System Control 
Programming Reference Manual, GC2 1-5077. 

A System/3 RPG 11 telecommunications program can exist 
within a dual programming system (Dual Programming Fea- 
ture required). Normal operator attention is required to 
respond to processing halts. 

Note: If you are attempting to communicate between 
two programming levels using the RPG II telecommunica- 
tions features and dual BSCA, it is suggested that you do 
not have overlays in either of the RPG II programs. 

For IBM System/3 telecommunications operating procedures, 
see your system's operator's guide. 
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BSC Telecommunications Concepts and Terminology 



This section describes the basic characteristics and opera- 
tional concepts of the BSC telecommunications system: 
what it is, how its parts are related, and how control is 
maintained. Commonly used terms are italicized. 



TELECOMMUNICATIONS NETWORKS 

A telecommunications system may use a nonswitched net- 
work or a switched network (Figure 1). 
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The Inlcgralcd C\)mniunicalions Adapter (IC'A) must be addressed 
as BSC''\ line 2. The manual ICA switch can liave only one interface 
active at any one time. 

See ITjiure 1 (Part 1 of 2) for examples of BSC'A line configurations. 



I'igurc 1. Telecommunications Networks (Part 2 of 2) 



Nonswitched Network 

A nonswitched network consists of a number of private or 
leased communication lines that connect a computer to one 
or more remote terminals. Remote terminals is a general 
term used to represent interconnected equipment at a 
remote location, having either input or output capability, 
or both. On nonswitched networks, the computer and 
remote terminals are physically connected, that is, the 
circuits making up the communication lines are continuously 
established for predetermined time periods, during which 
data may he transmitted over the lines. 

The lines that comprise a nonswitched network are variously 
known as private, leased, or dedieated lines. These lines 
may be furnished by a common carrier on a contract basis 
between specified locations for a continuous period or for 
regularly recurring periods at stated hours, for the exclusive 
use of one customer. 

hi this publication the term nonswitched network refers to 
a network in which the communication lines linking the 
computer and the remote terminal are continuously estab- 
lished, thus requiring no dialing to establish the connection. 



Switched Network 

A switched network allows many remote terminals to 
communicate with a computer without requiring dedicated 
communication lines. The computer and the remote termi- 
nals are connected by aeeess lines to the common carrier 
exchange serving their respective locations. A complete 
and continuous data path is estabhshed between the com- 
puter and the remote terminal only for the period of time 
in which data transmission takes place. The connection is 
established by dialing the telephone number of the remote 
terminal. 

In switched networks, line refers to a discrete data path 
between the telecommunications control unit, or adapter, 
and the common carrier exchange. The service provided by 
the common carrier is usually on a time-used basis. 

In this publication, the term switched network refers to any 
network in which a direct physical connection between the 
computer and the remote terminal must be established by 
dialing in order for data transmission to occur. 



multipoint, on nonswitched lines, and point-to-point con- 
tention, on both switched and nonswitched lines. The 
BSC telecommunication system permits communication 
using either type of connection (Figure 1). 



Multipoint 

If a remote terminal is connected via a multipoint line, data 
is sent and received under the control oi' the central or 
control station. In order to send or receive data, the remote 
terminal, referred to as a multidropped terminal or tributary 
station, must be selected by the control station. Tliis pro- 
gess of station selection is called polling or addressing. 

Note: System/3 cannot be a control station. 



Polling: Polling is a request to a tributary station to trans- 
mit data to the control station. Once the bributary station 
has accepted the invitation, thru recognition of its unique 
polling characters sent by the control station, the remote 
terminal may use the line to send data. 

The tributary station notifies the control station when data 
transfer is complete by sending a unique Knil-oJ-Transttiission 
(EOT) character to the control station. (For more informa- 
tion on control characters, sec Data Link Control in this 
section.) Upon receipt of the EOT sequence, the control 
station may poll or address another tributary station. 



Addressing: Data transfer from the control station to the 
tributary station on a multipoint network is accomplished by 
addressing the selected tributary station. Addressing is a 
request to a tributary station to receive data. 

The control station notitles the tributary station when data 
transfer is complete by transmitting the EOT sequence. 
After EOT has been sent, the control station polls or 
addresses other tributary stations connected via the multi- 
point network. 

Only the control station has the right to request data 
transfers on a multipoint network. 



Point-to-Point 



NETWORK CONTROL 

Initial contact between a computer and a remote terminal 
may occur in two ways, dependent on the type of line 
connection between them. The connections possible arc 



The other type of line connection is point-to-pt)int con- 
tention, with the computer and the remote terminal connected 
via a nonswitched or switched line. 



BSC ■|'elccoiiiniunicalions ("(inccpls ami Teniiin()l(ij;y .s 



Non-Switched: On a nonswitched line, either the computer 
or the remote terminal may initiate the transmission of data. 
However, if both stations simultaneously attempt to transmit 
or receive data, the line is disconnected. 



Switched: On a switched line, one of the stations is desig- 
nated as the calling station. The other stations, or called 
stations, accept calls from the calhng station. The calling 
station may perform the calling sequence by either autocall 
(automatic dialing by the computer) or manual dial (diahng 
performed by the machine operator). The called station 
accepts calls from the calling station by eiihex autoanswer 
(automatic answering by the computer) or manual answer 
(machine operator makes the data set ready). 

The calling station must initiate data transmission by sending 
the proper control sequence to ensure that a connection 
has been made with the desired station. The control se- 
quence usually involves the exchange oi station identification 
sequences. When station identification sequences are used, 
data transmission will not begin until both the called and 
the calling station have sent and received the correct ID 
sequence. 

When the control sequence has been completed, the calling 
station may either send data to the called station, or may 
relinquish the right to send data by sending an End-of-Trans- 
mission character. Once the EOT has been sent, the called 
station may initiate sending data to the calling station. When 
both stations have completed sending data, the calling station 
starts a disconnect procedure to terminate the data link. 



DATA LINK CONTROL 

Data link control procedures are used to ensure the proper 
sending and receiving of data between the computer and the 
remote terminal. System/3 BSCA support assumes the 
responsibility for maintaining the proper data link control 
procedures. 

The following information is presented to provide the 
System/3 programmer with sufficient information to 
properly utilize the BSCA capabilities. 



By using data link control characters, the computer and 
the remote station notify each other of their status, and 
the status of data sent or received by them. During normal 
operation, the data link characters cannot be included in the 
data being sent or received. 



Data Link Message Codes 

The BSC adapter is capable of sending or receiving data in 
one of two codes: EBCDIC (Extended Binary Coded Deci- 
mal Interchange Code) or ASCII (American National Stand- 
ard Code for Information Interchange). The code you use 
is determined by the type of BSC adapter installed in your 
system. 

EBCDIC and ASCII character code charts are provided in 
Appendix A of this manual. 



DATA LINK MESSAGE FORMATS 

Standard Format 

The standard message format consists of characters of data 
from the code selected, excluding specially designated data 
link control characters. 

EBCDIC Transparency 

BSC adapters with the EBCDIC transparency feature in- 
stalled may send and receive messages containing any or all 
of the possible 256 character combinations in the EBCDIC 
code, including data link control characters. This feature 
allows unique data, such as packed decimal data, to be 
sent unaltered from one computer to another. 

Intermediate Block Checking Mode (ITB) 

The intermediate block checking feature allows large 
buffers of data to be sent and received with parity checking 
performed on each logical record rather than the total 
buffer. The ITB character delimits logical records within 
the buffer. 



Data Link Control Characters 



Data link communication control between stations, that is, 
between the computer and the remote terminal is main- 
tained by the use of Data Link Control Characters 
(Appendix B). 



RPG II BSCA Programming 



System/3 RPG II Telecommunications Programming pro- 
vides the RPG II user witii the capabihty of transmitting 
and receiving binary synchronous data via a telecommuni- 
cations network. BSCA support is achieved through the 
use of an RPG Telecommunications Specifications Sheet 
and the addition of BSCA as a valid device entry on the 
RPG File Description Specification. No other RPG speci- 
fication sheets are affected by BSC. 



BSCA STATION TYPES 

RPG II permits System/3 to function as any of the following 
station types: 

1. Receive only (receive input data from a remote 
terminal). 

2. Receive with transmittal of conversational reply 
(receive input data from a remote terminal and, 
when required, transmit data as an acknowledgement). 



3. Transmit only (transmit data to a remote terminal). 

4. Transmit with reception of conversational reply 
(transmit data to a remote terminal and, when required, 
receive data as an acknowledgement). 

5. Transmit and receive-no conversational reply. Three 
modes of operation are possible: 

a. Transmit a file, then receive another file. 

b. Receive a file, then transmit another file. 

c. Transmit records of a file interspersed with receiv- 
ing records of another file. (This function is avail- 
able only when System/3 transmits data to OS or 
DOS. System/3 must transmit first.) 

A description of these functions, including complete RPG II 
programs, are provided following the description of the 
specification sheets. 

Note: Each telecommunications program implies a counter- 
part at the other end of the line. The two programs must be 
compatible. For example, a program which transmits 
ASCII data requires a program which will receive ASCII 
data. 
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RPG II TELECOMMUNICATIONS SPECIFICATIONS 

"file RPG Telecommunications Specifications Sheet (Figure 
2) permits t?ie RPG 11 programmer to enter tiie information 
necessary to establisli and maintain tlie BSC communica- 
tions link. Each BSCA file defined on the RPG File De- 
scription Specifications Sheet must have a corresponding 
RPG Telecommunications Specifications Sheet. 



Columns 1-2 (Page) 



Columns 3-5 (Line) 

Entry Explanation 

Any number Line numbers. 

Columns 3-5 are used to number the lines on the page. 
Columns 3-4 are preprinted, so in most cases line numbering 
is done for you. 



Entry Explanation 

01-99 Page number. 

Columns 1-2 in the upper riglit corner of tlie specifications 
sheet arc used to indicate the page number. The Tele- 
communication Specifications must follow the File Descrip- 
tion and any File Extension and Line Counter Specifications 
Sheets. 



Column 6 (Form Type) 

Entry Explanation 

T 



IBM 



-pr-r-,- 



Column 6 must contain a T. T identifies this 
page as a Telecommunications Specification. 



RPG TELECOMMUNICATIONS SPECIFICATIONS 
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Figure 2. Telecommunications Specification Sheet 
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Column 7 (Comments) 

Entry Explanation 

* Comments line. 

You often want to write comments that will help you 
understand or remember what you are doing in a certain 
section of coding. RPG II allows you to use an entire 
line for these comments. The comment line is identified 
by placing an asterisk (*) in column 7. Comments are not 
instructions to the RPG II program. They serve only as a 
means of documenting your program. 

Columns 7-14 (File Name) 

Entry Explanation 

alphameric This entry must be the same as the file name 
associated with the BSCA device on the File 
Description Specifications Sheet. 

Column 15 (Configuration) 

Entry Explanation 

P or blank Point-to-point, nonswitched network (PTP). 

M Multipoint network, where the control sta- 

tion selects the tributary station through 
polling or addressing. System/3 cannot be 
the control station. 

S Switched network. 



Column 17 (Type of Control) 



Entry Explanation 

T This is a tributary station on a multipoint 

network. System/3 cannot be the control 
station and transmit the polling supervisory 
sequence. 

blank PolHng is not used. 

Column 17 must contain a T if column 15 contains an M 
(multipoint network). 



Column 18 (Type of Code) 

Entry Explanation 

A, U ASCII (formerly referred to as USASCII) data 

link control characters will be used. When 
ASCII is used, each station must provide file 
translation when it is required. 

E or blank EBCDIC data link control characters will 
be used. 

The entry in this column must be the same type that your 
BSCA and RPG II program supports. ASCII and EBCDIC 
codes are listed in Appendix A. 

Note: If your BSC program halts because of an invahd 
ASCII character in your data, check your ASCII translation 
table. 



Column 16 (Type of Station) 

Entry Explanation 

T This station will transmit messages from this 

file (transmit only or transmit with reception 
of conversational reply). The file must be 
designated as an output or combined file on 
the File Descripdon Specifications Sheet and 
must appear on the Output Format Specifica- 
tions Sheet. 

R This station will receive messages into this file 

(receive only or receive with transmittal of 
conversational reply). The file must be desig- 
nated as an input or combined file on the File 
Description Specifications Sheet and must 
appear on the Input Specifications Sheet. 

Note: This entry is independent of the entry in column 20. 



Column 19 (Transparency) 

Entry Explanation 

Y This entry is valid only for EBCDIC. The 

transparency feature must be installed. 

The data being transferred may contain data 
link control characters. EBCDIC data link 
control characters are listed in Appendix B. 

N or blank The transparency feature is not used. Un- 
packed numeric or alphameric data will be 
transmitted and received. The data being 
transferred may not contain data hnk control 
characters. 
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Column 20 (Switched) 



Entry Explanation 

I M The computer operator using this program makes 

the connection between stations by dialing the 
number (manual dial). 

I 

E Autocall is to be used by this station. The dial 

number is listed in columns 21-31. 

S Autocall is to be used by this station. The entry 

in columns 21-31 is the symbolic location of 
the dial number. 

I A Autoanswer is used by this program. 

I B Manual answer is used by this program. 

blank This is not a switched network. 

Notes: 

1. When calling, you should use E, M, or S. If 
the program is to be called, you should use A 
or B. That is, if two RPG II programs are 
communicating, one program must have an 
E, M, or S, and the other must have an A or B. 

2. This entry is independent of the entry in 
column 16. 



Columns 21-31 (Dial Number) 

Entry Explanation 

numeric This is the number to be dialed when column 

20 contains an E. 

alphameric Columns 21-31 must contain a symbolic 

name, other than an array name, referencing 
the location of the dial number when column 
20 contains an S. If the BSCA file is an input 
file other than a demand or conversational 
receive file, this name must refer to the first 
(or only) element of a table. This ensures 
that the dial number will be in storage before 
the telecommunications line is opened. 
(This restriction does not apply when the 
function of the program is transmit with 
conversational reply.) 



Column 32 (Location of Identification— This Station) 

Entry Explanation 

S Switched network. This station's identification 

is located at the position referenced by the 
symbolic name specified in columns 33-39. 

E Switched network. The entry in columns 33-39 

is this station's identification. 

blank This is a nonswitched network or a switched 

network where no ID is desired for this station. 

Columns 33-39 (Identification-This Station) 

Entry Explanation 

alphameric When column 32 contains an E, this entry 
is the actual identification sequence of this 
station (minimum two characters). 

When column 32 contains an S, this entry is 
the symbolic name of the location of this sta- 
tion's identification. The symbolic name 
must not be an array name. If the BSCA file 
is primary or secondary, this symbolic name 
must refer to the first element of a table. 
(The table may have only one element.) This 
ensures that the station identification will be 
in storage before the telecommunications 
line is opened. 

The station identification can be from two to 
fifteen characters; however, the length of 
this field or literal must be the same as the 
length of the field or literal in columns 
41-47 (blanks in Uterals do not count as 

part of the length). A station identification 
must not contain a control character sequence 

(see Appendix B). The station identification 

will be translated if the BSCA files are being 

translated. 
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Column 40 (Location of Identification-Remote Station) 

Entry Explanation 

S Switched network. The remote station's 

identification is located at the position 
referenced by the symbohc name specified 
in columns 41-47. 

E Switched network. The entry in columns 

41-47 is the remote station's identification. 

blank This is a nonswitched network or a switched 

network where no ID is desired for the remote 
station. 

Columns 41-47 (Identification- Remote Station) 

Entry Explanation 

alphameric When column 40 contains an E, this entry 
is the actual identification sequence of the 
remote station (minimum two characters). 
When column 40 contains an S, this entry is the 
symbolic name of the location of the remote 
station's identification. The symbolic name 
must not be an array name. If the BSC file is 
primary or secondary, this symbolic name must 
refer to the first element of a table. (The table 
may have only one element.) This ensures that 
the station identification will be in storage 
before the telecommunications line is 
opened. The station identification can be 
from two to fifteen characters; however, 
the length of this field or literal must be 
the same as the length of the field or 
literal in columns 33-39 (blanks in literals 
do not count as part of the length). A 
station identification must not contain a 
control character sequence (see Appendix 
B). The station identification will be 
translated if the BSC files are beuig 
translated. 
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Columns 48-51 (Remote Terminal) 

Columns 48-5 1 are used only if System/3 is to communicate 
with the IBM 2770 Data Communication System or the 
IBM 2780 Data Transmission Terminal (see Appendix E). 
Otherwise, columns 48-51 are never used with System/3 
and must be blank. 



Column 52 (ITB) 

Entry Explanation 

I Intermediate block check (ITB) is used. 

blank ITB is not used. 

Intermediate block checking can be used only if records 
are blocked. 

Columns 53-54 (Permanent Error Indicator) 



Entry 



Explanation 



01-99,L1-L9 A permanent error indicator should be used 
LR,H1-H9 with every BSC file. If you are using more 
than one BSC file, each should have a per- 
manent error indicator, not necessarily 
unique. 

When a permanent error occurs, the specified 
error indicator and the identification indica- 
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tor of the record causing the error are both 
set on. The permanent error indicator should 
be used to condition appropriate program- 
ming response (for example, printing a mes- 
sage or performing a controlled cancel). No 
further transmission should be attempted 
while the permanent error indicator is on. 

If you are using dual I/O buffers on the 
Card System and a permanent error occurs 
when the first record is received, a system 
halt is issued automatically. 

Disk systems only: To retry an operation 
after a permanent error occurs, turn off the 
permanent error indicator. Tlie RPG II pro- 
gram can then access the BSC file that 
caused the error. If no error occurs, pro- 
cessing continues; otherwise the permanent 
error indicator is turned on again. 

Keep the following points in mind when you 
retry an operation: 

1. The permanent error indicator is the 
only indicafion given to the RPG II 
program that an error has occurred. 

2. Any data in the BSC buffers at the 
time of an error is lost. 

3. Switched lines are not disabled when 
an error occurs except for disconnect 
sequence received or hardware de- 
tected disconnect. 

4. Any data passed to the user while the 
permanent error indicator is on is 
invalid. Unless your program recog- 
nizes all data, an unidentified record 
halt may occur. 

5. A limit should be imposed by the 
RPG II program on the number of 
times an error occurs before stopping 
the program. 
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blank No permanent error indicator is specified. 

If a permanent error occurs on a card or disk 
system when no permanent error indicator 
has been specified, a system halt occurs. The 
program cannot be restarted. 

Note: Avoid using H1-H9 as permanent error indicators if 
you wish to condition operations on the permanent error 
indicator being off. Since H1-H9 are reset at the end of 
the detail cycle, they may be set off before the program 
cycle in which the error occurred is completed. 

Also, when H1-H9 is used as a permanent error indicator, 
the H1-H9 display may preempt the system halt display. If 
the H1-H9 display appears before the system display, dial 
the option on a disk system or restart the card system to 
prompt the system halt display. 



Columns 55-57 (Wait Time) 

Entry Explanation 

numeric The length of time in seconds, 1-999, that BSC 
will wait with no messages being sent or re- 
ceived before a permanent error condition 
occurs. 

blank The system convention for timeout, 180 

seconds, is used. 

A permanent error results whenever the wait time elapses on 
an idle line. Therefore, when you determine your wait time, 
consider time the operator may require to respond to halts 
and other processing interrupfions, and also time the program 
may require for special operations such as table searches, 
computing square roots, etc. 

Note: The time limit specified applies only to delays 
caused by this System/3 program and does not apply to 
the remote device. If the remote device does not commun- 
icate with this System/3 within a 20-second period, a 
permanent error condition occurs. In addition, the time 
Umit applies only during the transmission of a file, not 
between file transmissions. The occurrence of a permanent 
error indicates the end of processing of a file. 



Columns 58-59 (Record Available Indicator) 

Entry Explanation 

01-99, A record available indicator should be assigned 

L1-L9, to every BSCA input file that is to be reopened. 
LR, (If a file is used again after end-of-file has been 

H1-H9 reached, the file is "reopened.") See Figure 9 

and Appendix F for examples using a record 
available indicator. This indicator is set on 
whenever a reverse interrupt (RVI) is received. 



Column 60 (Last File) 

Entry Explanation 

L This BSC input file is processed only after all 

other primary and secondary input files have 
been processed. 

blank It isn't necessary that this BSC input file is 

the last input file processed. 



Columns 61-62 (Polling Characters) 

Entry Explanation 

Alphameric The polling identification of this station is 
needed if this station is part of a multipoint 
network and the BSC file is a transmit (out- 
put) file. Polling characters are listed in 
Appendix C. 

blank This station is not transmitting on a 

multipoint network. 
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Columns 63-64 (Addressing Characters) 

Entry Explanation 

Alphumenc The addressing identification of this station 
is needed il' tliis station is part ol' a multi- 
point network and tlie BSC file is a receive 
(input) file. Addressing characters arc 
listed in Appendix C. 

blank This station is not receiving on a multipoint 

network. 

,\'otL': hnter polling and addressing characters in System/.^ 
code; the compiler will convert the characters to the form 
required by the code specilied in column 18. 



Columns 65-70 (Remote Device) 

('olunniN (i.v70 arc used only if System/3 is to communicate 
with the IBM 2770 Data ('ommunicaiion System or the 
IBM 2780 Data Transmission Terminal (See Appcndi.x H). 
Otherwise columns 6.S-70 are never used with System/3 and 
must be blank. 



Columns 71-74 (Reserved) 

Columns 71-74 are never used with System/3 and must be 
blank. 



Columns 75-80 (Program Identification) 

Columns 75-80 may contain any characters. These columns 
may use the program name in the control caid. or they may 
contain cliaracters which idcntil'y a certain portion of the 
program. The entry is ignored by the compiler, but will 
appear in the source program listing. 



FILE DESCRIPTION SPECIFICATION ENTRIES FOR 
BSC FILES 

The entries in the columns listed below are used to define 
a BSCA file on the RPG File Description Specifications 
Sheet. The entries in columns not listed are the same as 
basic RPG. 

No other RPG specification sheets are changed by BSC. 
However, since a BSC program must not be interrupted, a 
B must not be entered in column 37 of the RPG II Control 
Card Specifications when the BSC program is to be run on a 
disk system. 



Columns 7-14 (File Name) 

This is the name of a BSC file. The same file name must be 
used on the RPG Telecommunications Specifications Sheet. 

Note: Look-ahead fields must not be specified for a BSC 
file. 



Column 15 (File Type) 

El 1 try Explana tio n 



I 

O 

C 



This is an input (receive) lllc. 

This is an output (transmit) file. 

Combined file. Use C when your receive file 
or transmit file uses conversational reply. Un- 
like combined card files, the acknowledgement 
sent as a conversational reply may or may not 
be added to the last record received. 

C is an invalid entry if an IBM 2770 or IBM 
2780 IS being used. 
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Column 16 (File Designation) 

This is tlic s;inie as basic RPCi excepi thai: 

1 . D ( dcinaiid file ) is tiie required entry li)r imnsinir 
interspersed with receive. BSC'A tiles alsi) shoLiid be 
designated as demand fiJes with any receiving program 
whicli does not address the BSCA files immcdialely. 
For example, ii'your BSCA file is defined as a sec- 
ondary file, the telecommunications line will be 
opened as soon as the program begins. This means 
thai your wail time may elapse bciore you arc ready 
to process the BSCA file. If the BSCA i'ile is defined 
as a demand fiJe, however, the line will be opened 
only when the program is ready to receive from ihc 
BSCA file. 

2. R (record address file) is an invalid entry. A BSCA 
file cannot be a record address file. 



Column 17 (End of File) 



Columns 24-27 (Record Length) 

Inter ihe lenjuii ni youi- HS( A iccords. ligisi |u>tiricil. m 
^ ohimn> ^'-^ '. h \ Oil! BSC,\ ides use convcisalioiiai rc- 
pK. lecord lengiii iiiu>; l)c ihc same as l)io,:k !en^!!!i. I i' 
\ ou do !hii specif} a recoid length, ihe lecord lengiii will 
be dclaulied lo /eio. The nuiximiini iccoi d icin'flis are 
4(W6( Model 10 Card Svslemiand ')t)M') ( Model (,. Model 
10 Disk Sysiein. .Model 12. and Model 15). 

A'utc: When ihe l!ansmui..d i^j^ord l, ie-,i ti;:,!ii inc ic^oid 
length specification rleid in ihc liiOurani. ihe daia m ihe 
remamdei of liic bufter ma\ cauM.- inii-icdic;;!:!!,; iCsulis. 



Column 32 (Additional Area) 

Assign dual I/O areas. This column is iise>,i i>n!y vis;h ;;. 
conversational BSCA i'iles. Any iiumhci. i ininugi) " ., 
two 1,0 areas lo be assigned, if iliis coiumi; is bhinK. ■,; 
one I/O area is assigned and ihrotiglipui is dccre.i^ed a..i 
ingly. 



baiter an b if end-c^f illc on the input (receivci lile is u,- de- 
termine end-of-job. flie BSCA mpui file can be the only 
flic with an H in colnmn 17. if any other inpui file has an 
b specified in column 17. then ail BSCA inpui files should 
have an \i in column 17. The 1/ in column 17 is noi man- 
datory but withoul it when end-of-file is reached on ilie 
other file, the BSCA file will be closetl wiihoui giving (he 
system on ihe other end an indication of whal has 
happened. By using the \l in column 17 for all BSCA 
input Hies, all systems will come to a successful end-of-iob. 



Column 19 (File Format) 

Enter an F (fixed length) for BSCA files. 



Columns 20-23 (Block Length) 

Fnier the size of the blocks of tiata lo be [irocessed by 
BSC. If your BSCA files use conversational replw block 
length must be the same as record length; otherwasc, block 
length can be a multiple of record lengili. The nia.ximum 
block lengths are 40^)6 ( Model 1 Card System ) and '-)^M^) 
(Model 6, Model 10 Disk System. Model 12. and Model 15) 



Columns 40-46 (Device) 

The device entrv ior BSCA tiles is 15SCA. 

Note: On the Model 10 Disk System. Mode! 12. Model o 
and Model 15, ihe maximum number of iioii-BSC/\ files 
allowed m a program using BSCA files depends upon ihe 
number of BSCA tiles: 



Number of BSCA files 
in program 


Maximum number of 
non-BSCA files allowed 


1 


19 


2 


17 


3 


15 


4 


12 


5 


10 
8 


6 


7 


6 


8 


4 


9 


2 


10 
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DESCRIPTIONS OF BSC FUNCTIONS 

This section describes the functions that System/3 can per- 
form as part of a telecommunications network. Complete 
RPG 11 programs are included to show how these functions 
may be used. 



Programming Considerations 



RPG II First-Time Logic 

RPG 11 first-time logic opens all primary and secondary in- 
put files during the first-time cycle. That is, one record is 
read from each primary and secondary input file before 
any input file is processed. However, depending upon the 
particular application, you may want to delay first-time 
logic for your BSCA input files. You can achieve this by 
designating each BSCA input file as a demand file (D in col- 
umn 16 of the File Description Specification sheet). One 
BSCA input file can also be designated as the last file (L in 
column 60 of the Telecommunications Specification sheet). 

Remember that an entire BSCA input file must be received 
before another, or part of another. BSCA mput file can be 
received. 



Data Restrictions 



• Remember that /* in the first two positions of a record 
always signifies end-of-file. This applies even to data 
transmitted and received in a BSC program. Therefore, 
be sure tliat the use of hterals, constants, or OS or 
DOS data records does not result in the transmission 
of /* in the first two positions of a record. 

Note: Wlien a table is dumped, a /* is generated to denote 
the end of die tabic. Therefore, if you dump a table !o a 
BSCA file, expect an end-of-file condition when the table 
has been received. 

• If you have the auto-turnaround feature and you are 
communicating in transparent mode to the IBM 2780, 
the last record received by System/3 before turning the 
line around will be blank. Consider this when you spec- 
ify record identifiers in the RPG input specifications. 

Details of transmitting data sets on tiie 3741 can be found 
in t he IBM System/ 3 374 J Models 3 and 4 Programmable 
Work Station Programming Reference Manual, GA21-9194, 
oi- IBM 3741 Data Station Reference Manual, GA2 1 -9 183. 

Data Formats 



Control Breaks and Overflow 

Care must be taken when transmitting data at tolal time in 
any RPG 11 program which both transmits and receives. 
Due to the sequence of total and detail operations in tiie 
RPG Jl Program Cycle, data may not be available 
even though it has been read. 



for output 



Similar care must be taken when assigning the overfiow 
indicator in a program that both transmits and receives. A 
potential problem exists in that RPG li, because of the pro- 
gram cycle, may try to transmit an overflow record after 
receiving a record. 



Syslem/3 RPG 1! support uses the following data formats 
lor transmission of data -these formats must be used when 
sending data to System/3 from a CPU. The BSCA support 
provides these for the RPG 11 user. 

• Non-transparent, non-lTB: 
STX-dala-ETX (E FB) 

• Non-transparent, 1TB: 
SfX-aala-lTB-data-!TB-data-ETX(ETB) 

• Transparent, non-lTB: 
DLE-STX-data-ETX(ETB) 

• rransparent, 1TB: 

DLESTX-data-ITB-DLE-SlX-data-lTB-DLE-STX-data- 
liTX (ETB) 



Note: B TAM cannot send iransparcnt 1TB data, but can 
receive transparent 1TB data. 

Data can he either fixed length and unblocked, or blocked 
with fixed record length, if 1TB mode is used, the 1TB 
character must precede each record except the first, and 
should not be counted in the record leimth. 
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Errors 

If an error occurs at either station, System/3 will retry the 
operation a maximum of seven times. 

System/3 halts with a permanent error if it receives: 

• An EOT while transmitting 

• The following sequence of data lini< control characters: 
TTD-NAK-EOT. 

RPG II Diagnostics 

Refer to the RPG 11 reference manual for your system for 
a discussion of compile time RPG II diagnostics. 

Model 15 Only 

Because the BSCA program is an interrupt driven program 
and cannot be rolled out of its partition, care must be taken 
when using BSCA files with SPECIAL files (where allocation 
of system supported disk devices is performed) or unpre- 
dictable results will occur. To prevent the program from 
being rolled out by allocation, the RPGTCF programmer 
must ensure that the BSCA data management DTFs and 
lOBs are located 6K bytes beyond the beginning of the 
partition. 



Receive Only 

The receive only function allows the RPG 11 user to receive 
input data from a remote terminal. The file may be either 
a primary or secondary file. Blocked records are permitted. 
Dual I/O areas can be used to achieve greater throughput. 

The receive only file is defined as an input file on the RPG 
File Description Specification and as a receive file on the 
RPG Telecommunications Specification. 

In the following rece/ve only program (Figure 3), a branch 
office is transmitting a daily sales report to Systcm/3. The 
information received is listed on the printer and punched 
and printed on cards. The salesman's name is sent on one 
record. This record is followed by any number of records 
identifying his sales for the day. The card file produced by 
this and other day's transmissions can be sorted and used by 
another RPG 11 program as data to calculate information 
such as inventory control and the salesman's commissions. 
The same program could then transmit this information 
back to the branch office. 
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File Description Specifications (Figure 3, Part 1) 
Column Description 



7-14 

15-16 
17 

20-27 

32 

40-46 



SALES IS the file which contains the sales 
report received by this station. 

SALES is the prrmary input file for this 
program. 

End-of-file on SALES does not determine 
end-of-job time. 

BSCA files always have a fixed length format. 

Records are blocked. 

Dual 1/0 areas are used. 

BSCA is the device used for BSCA files. 
BSCA is also specified when ct)nimunicating 
with a device attached via the Local Communi- 
cations Adapter. 
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Telecommunications Specifications (Figure 3, Part 1) 

Column Description 

1-\A SALES is the BSCA file for this program. 



15-17 



18-20 



32-47 



5 2 



This station is part of a switched network 
(S), and will receive messages (R). Polling is 
not used, so column 17 is blank. 

EBCDIC code (E) and the transparency 
feature (Y) are both used. Autoanswer (A) 
is used by the called station. 

Explicit station identification sequences are 
given for each station. Station IDs ensure 
data security on the switched network. 

Intermediate block check (I) is used. 
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Column Description 



Input Specifications (Figure 3, Part 2) 



53-54 The permanenl error indicator used is 99. 

55-57 Tiie telecommunications line will be kept 

open for 1 20 seconds even though no 
messages arc being sent or received. After 
1 20 seconds have elapsed, a permanent 
error condition results if the line still is 
not being used. 



Data transmitted by the remote station is received by 
SALES. 



Calculation Specifications (Figure 3, Part 2j 

If a permanent error occurs, LR is set on to enter end-of-job 
processing. 
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Outpui f-ormat Specifications (Figure 3, Part 3) 

A pcrnianciu cno; causes an crrur mcs,a-c U) be pnnlcd 
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Receive with Transmittal of Conversational Reply 

fhe receive witli traiismiUal of convers.iluMiai reply i'uiiclinn 
allows the RPG 11 user to receive dala and. when necessary, 
to send a record to the remote terminal. Dual I/O areas and 
blocking or deblocking ol data are not perniiited. 

The receive witli transmittal oi' conversational reply file is 
defined as a combined iile on the RPG File Description 
Specifications .Sheet and as a receive file on the RPG Tele- 
communicaiions Specilications Sheet. 



File Description Specifications (Figure 4, Part 1 ) 
Column Description 
7-14 SALES is a BSC file. 
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lb 



SALES is a combined file since it will receive 
dala and transmit a conversational reply. 

SALES is the primary input file for this 
program. 



The following program (Figure 4) is similar to the receive 
only program; however, the receiving station can now send 
a response to the remote station if the information received 
is incomplete. 



17 End-ofTlle on SALES does not determine 

end-of-job time. 

19 BSC files always have a fixed length format. 

20-27 Blocking and deblocking are not permitted 

for conversational BSC files. 



40-46 



BSCA is the device used for BSC files. 
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Telecommunications Specifications (Figure 4, Part 2) 

Column Description 

7-14 SALES is the BSC file lor this program. 

1 5-1 7 This station is part of a switched network 

(S) and will receive with conversational 
reply (R). Polling is not used, so column 17 
is blank. 

18. 19,20 EBCDIC code (E) is used, but the trans- 
parency feature is not used (N). Autoanswer 
(A) is used by the called station. 

32-47 Explicit station identification sequences are 

given for each station. Station IDs ensure 
data security on the switched network. 

53-54 The permanent error indicator used is 88. 

55-57 The telecommunications line will be kept 

open for 45 seconds even though no mes- 
sages are being sent or received. After 45 
seconds have elapsed, a permanent error 
condition results if the line still is not being 
used. 
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1-iLUirc 4. Receive with Transmittal of Conversational Reply Program (Part 2 of 4) 



RP(. il B.SCA Pro!:iammin;j 



Input Specifications (Figure 4, Part 3} 

Line 02. columns 69-70: If SLSMAN is absent tVoiii a 
record having an N in position 1 , indicator 99 is set on. 



Caicuiation Specifications (Figure 4, Part 3j 

II a permanent crioi' occurs. LR is set on to enter end-ol'-ioli 
processing. 
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Output Format Specifications (Figure 4, Part 4) 

Page 05, lines 15-16: A permanent error causes an error 
message to be printed. 



Page 06. lines 9-11: When indicator 99 is set on, a conver- 
sational reply is sent from SALES. 
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Transmit Only 

The traiisinii only tunction allows the RPG II user to 
nansmit BSC data to a remote location. Dual I/O areas 
and blocking ofdata can be used to increase throughput. 

riic transmit only i'ile is defined as an i)iitpul lile on the 
RPCj File Description Specifications Sheet and as a transmit 
lie on the RPCj Tclecommimicatitins Specifications Sheet. 



Tdiis transfiut only program (Figure 5) is reading and trans- 
uiitting tlie card files produced b\' the receive only program 
I Figure ,^). I'lie week's data has been sorted by salesman 
name. The amount of each sale has been punched into the 
cards and the total sales for eacli salesman is transmitted to 
the branch otTice. After all cards have been read, the total 
of all sales is transmitted. 



File Description Specifications (Figure 5, Part 1) 
Column Description 

WKLYSMRYisa BSCA file. 



7-14 
15 

19 

20-27 
32 
40-46 



Since WKLYSMRY is to be transmitted, it 
IS an output file. 

BSCA files always have a fixed lengtli format. 

Records are blocked. 

Dual I/O areas are used. 

BSCA is the device used for BSCA files. 
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Te/ecommunications Specifications (Figure 5, Part 2) 

Column Description 

7-14 WKLYSMRY is the BSCA file for this pro- 

gram. 

15-17 This station is part of a switched network (S), 

and will be transmitting (T). Foiling is not 
used, so column 17 is blank. 

18-19 l-BCDIC code (IZ) and the transparency 

I'eature (Y) are both used. 



Column Description 

5- liueiniediate block check (1) is used. 

53-54 The permanent errt)r indicatoi" used is 25. 

55-57 The telccomnuiiiicatioiis line will be kepi 

open tor 70 seconds even though no mcs.iag 
are being seni or received. .Alter 70 second; 
iiave elapsed, a permanent error condilion 
residts if ihe line still is noi beiii'.: used. 



20-31 Autocall is used (,S). and columns 21-31 

contain tiie synibolic location of the dial 
number. 

32-47 Symbolic locations are given for each station 

identification sequence. Station IDs ensure 
data security on the switched network. 



Input Specifications (Figure 5, Part 1 ) 

Lines (11-03: The tirsi card read coniains llie 
ol'tlie remote stalion and both s:,;h(;i; ^Jc:;::-' 
sec|ucnces. 
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Calculation Specifications (Figure 5, Part 3) 



Output-Format Specifications (Figure 5, Part 3) 



If a permanent error occurs, LR is set on to enter end-of-job 
processing. 



Lines 01-04: If a permanent error occurs, a message printed 
at total time identifies the record being processed when the 
permanent error occurred. However, because of record 
blocking and the use of dual I/O areas, all the records pre- 
ceding the record identified may not have been transmitted. 



Lines 05-10: When on, the permanent error indicator pre- 
vents the program from transmitting totals. 
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I igurc 5. Transmit Only Program (Part 3 of 3) 



Transmit with Reception of Conversational Reply 

The transmit with reception of conversational reply function 
allows the RPG II user to transmit data to a remote terminal 
and receive a record in return. The received record will be 
made available by RPG II on the next input cycle. 

Text may or may not be received for each block of text 
transmitted. When text is received, the user cannot send 
another block of text prior to processing the received 
record. Dual I/O areas and blocking or deblocking are not 
permitted. Matching fields are not permitted for the BSCA 
file. 

The transmit with reception of conversational reply file is 
defined as a combined file on the RPG File Description 
Specification and as a transmit file on the RPG Tele- 
communication Specifications. 



Programming Considerations 

1 . A conversafional reply is in effect forced by RPG II. 
That is, the reply is accepted at output time, but it is 
not available for processing at the receivmg station 
until the receiving station enters the next program 
cycle. When you transmit with receipt of conversa- 
tional reply, then, be sure to review your program for 
compatibility with the RPG II Program Cycle. Do not 
expect to process a record that will not be available 
for processing or output until the next program cycle. 

2. RPG II allows only one conversational reply for each 
RPG II Program Cycle. An error halt occurs if more 
than one conversational reply is received during one 
program cycle. The program is then terminated. 

3. The records must be of equal length for both input 
and output. 

This program (Figure 6) is similar to the transmit only 
program; however, the station receiving the transmission 
can now send a response that is printed on the System/3 
printer. 



File Description Specifications (Figure 6, Part 1) 
Column Description 
7-14 WKLYSMRY is a BSC file. 



15-16 



17 

19 

20-27 

40-46 



WKLYSMRY is a combined file since it will 
receive records and have records transmitted 
from it. WKLYSMRY is the secondary input 
file. 

End-of-file on WKLYSMRY does not deter- 
mine end-of-job time. 

BSC files always have a fixed length format. 

Blocking and deblocking are not permitted 
for conversational BSC files. 

BSCA is the device used for BSC files. 



Telecommunications Specifications (Figure 6, Part 7) 

Column Description 

7-14 WKLYSMRY is the BSC file for this program. 

15-17 This station is part of a switched network (S) 

and will be transmitting with reception of 
conversational reply (T). Polling is not used, 
so column 1 7 is blank. 

18-19 EBCDIC code (E) and the transparency 

feature (Y) are both used. 

20-31 Autocall is used (S), and columns 21-31 

contain the symbolic location of the dial 
number. 

32-47 Symbolic locations are given for each station 

identification sequence. Station IDs ensure 
data security on the switched network. 

53-54 The permanent error indicator used is 77. 

55-57 The telecommunications line will be kept 

open for 70 seconds even though no messages 
are being sent or received. After 70 seconds 
have elapsed, a permanent error condition 
results if the line still is not being used. 
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Input Specifications (Figure 6, Part 2) 

Lilies 01-04: The first card read contains the dial number 
of the remote station and botii station identification se- 
quences. 

Lines 08-09: A message of from 1 to 50 ciiaraclers is 
received as a conversational reply. 
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Calculation Specifications (Figure 6, Part 3) 

If a permanent error occurs, LR is set on to enter end-of-job 
processing. 



Output-Format Specifications (Figure 6, Part 3) 

Lines 01-02: Conversational replies received are printed to 
the output file REPLY. 



Line 03: A permanent error causes an error message to be 
printed. 

Lines 04-08: Data is transmitted from WKLYSMRY. 
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Figure 6. Transmit With Reception of Conversational Reply Program (Part 3 of 3) 
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Transmit and Receive (No Conversational Reply) 



Transmit a File, Ttien Receive a File 



Two files are defined, one as an input file on the RPG File 
Description Specifications Sheet and as a receive file on the 
RPG Telecommunications Specifications Sheet. The other 
file is defined as an output file on the RPG File Description 
Specifications Sheet and as a transmit file on the RPG 
Telecommunications Specifications Sheet. 

Transmit and receive RPG BSC programs can be written 
three ways: 



TTie receive file must not be defined as the primary input 
file on the RPG File Description Specifications Sheet. An 
L must be entered in the Last File Processed column of the 
telecommunication specification. Matching fields and the 
record available indicators may not be defined for the BSC 
files. 

System/'3 in this example (Figure 7) is a tributary station 
(polling characters RR) on a multipoint networl<;. OS or 
DOS is the control station (central) and polls the stations. 



Transmit a file, then receive a file. 

Receive a file, then transmit a file. 

Transmit interspersed with receive (System/3 to OS 

or DOS only). 



Programming Considerations 

In any BSC program which transmits and receives with no 
conversational reply, columns 15 and 17-47 must be identi- 
cal m the two RPG Telecommunications Specifications 

fines. 



System/3 reads a card file containing part numbers and 
number of parts required. The cards have been sorted into 
ascending order by part number and are sequence checked 
by specifying a matching field (M 1) on the RPG Input 
Specifications Sheet. The parts information is transmitted 
to the central when the central polls the station to see if 
any data is available. OS or DOS accepts the data from 
System/3 and sends back a list of parts that are not avail- 
able. The list is printed on the System/3 printer. The L in 
column 60 of the Telecommunications Specifications Sheet 
causes the file named ANSWER to be processed after the 
other input file. Normally, any file without matching fields 
would be processed first. 
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File Description Specifications (Figure 7, Part 1j 

Column Description 

7-14 ANSWER and REQUEST are BSCA files. 

15-17 ANSWER receives messages; therefore, it is 

an input file. It is the secondary input file, 
and determines end-of-job time. Since 
REQUEST is transmitted, it is an output file. 



19 



BSCA files always have a fixed length format. 



20-27 ANSWER is not blocked; REQUEST is 

blocked. 

40-46 BSCA is the device used for BSCA files. 
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Telecommunications Specifications (Figure 7, Part 2) 

C(/liii)m Description 



7-14 



15 



16 



IS-l') 

20-47 
53-54 



REQUEST and ANSWER arc the BSCA files 

for this program. 

This statn)ii is part of a multipoint network 
(M). 

RFQUHST will be transnntted (T); ANSWER 
will receive data (R). 

This station is a tributary station (T) in a 
multipoint network, and polling is tised. 

l-BCDIC ce)de (E) and the transpareney 
feattu'e (Y) are both used. 

Since polling is used, these columns are blank. 

rhe permanent error indicator used is 66. 



Column Description 

55-57 The tclecommimications line will be kept 

open for 100 seconds even though no mes- 
sages arc being sent t)r received. After 100 
seconds have elapsed, a permanent error 
condition results if the line still is not being 
used. 

60 ANSWER must be the last file processed ( L) 

because the scciuence of the |M"ogram is 
transmit a file, then receive a file. Without 
the L in column 60. ANSWER would be 
processed before PARTS, because PARTS 
has matching records. 

61-62 RR are the polling characlers used by the 

control station to rec|uest data from this 
tributary station. 

6.^-64 The addressing characters used by the control 

station to recjuest that this tributary station 
receive data are 99. 
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Input Specifications (Figure 7, Part 3) 

Lines 04-05: ANSWER, the secondary input file, receives 
data from the control station after REQUEST has been 
transmitted. 
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Figure 7. Transmit Then Receive Program (No Conversational Reply) (Part 3 of 4) 
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Calculation Specifications (Figure 7, Part 4) 

If a permanent error occurs, LR is set on to enter end-of-job 
processing. 



Output- Format Specifications (Figure 7, Part 4) 

Lines 01-03: Records read from PARTS are transmitted 
from REQUEST until end-of-file is reached on PARTS, and 
no more data is available for the control station. 



Lines 04-05: Records received by ANSWER are printed to 
LIST. 

Line 06: A permanent error causes an error message to be 
printed. 
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Figure 7. Transmit Then Receive Program (No Conversational Reply) (Part 4 of 4) 
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Receive a File, Then Transmit a File 



The receive file is defined as a primary or secondary file on 
the RPG File Description Specifications Sheet. The record 
available indicator must be blank on the RPG Telecom- 
munications Specifications Sheet. 



In the following example (Figure 8) all data for a student 
test given at a remote location is received by System/3. 
The first record contains the correct answers and the number 
of questions on the test (maximum 50). All following 
records contain student answers. The correct answers and 
the students answers are stored in arrays and compared. 
For each question the number of students that missed the 
question is then calculated and transmitted back to the 
remote terminal as an element of the array named RES. 



File Description Specifications (Figure 8, Part 1) 

Column Description 

7-14 GRADES and RESULTS are BSCA files. 

15-16 GRADES will receive data; therefore, it is an 

input file. It is the primary input file. 
RESULTS is the output file since it will be 
transmitted. 

1 7 End-of-file on GRADES causes LR to be 

set on. 

19 BSCA files always have a fixed length format. 

20-27 Both files are blocked. 

32 Dual I/O areas are used. 

40-46 BSCA is the device for BSCA fUes. 
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Telecommunications Specifications (Figure 8, Part 2) 

Column Description 

7-14 GRADES and RESULTS are the BSCA files 

for this program. 



1: 



17 
18-19 

20 
32-47 



This station is part of a switched network (S). 

(iRADES IS an input file and will receive 
data (R). RESULTS is an output file and 
will be transniitted (T). 

Polling is not used, so column 17 is blank. 

EBCDIC code (E) and the transparency 
feature (Y) are both used. 

Autoanswer (A) is used by the called station. 

Explicit station identification sequences arc 
entered. Station IDs ensure data security 
on the switched network. 



52 Intermediate block check (1) is used. 

53-54 The permanent error indicator used is 5.S, 

55-57 The telecommunications line will be kept 

open ior 70 seconds even though no mes- 
sages are being sent or received. After 70 
seconds have elapsed, a permanent error 
condition results if the line still is not being 
used. 



Input Specifications (Figure 8, Part 2) 

Lines 01-03: The first record received contains the number 
of ciuestions on the lest and the correcl answers to the 
questions. These answers form an array, a\NSARR. 

Lines 04-05: All records received after llie first record 
contain students' answers to the lest quesiions. These 
answers form the arrav S TDARR. 
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Calculation Specification (Figure 8, Part 3) Lines 11-18: When the entire input file (GRADES) has been 

received and the LR indicator set on, E^ES is transmitted 
Lines 01-02: If a permanent error occurs, LR is set on and 1>om RESULTS by exception output, one clement at a time. 

02 is set off to enter end-of-job processing immediately, unless a permanent error occurs. 



Lines 03-09: The array containing the correct answers n > * c *o -f ^- /r-- on o, 

,,,,„.„„,, , , ^ Output- Format Specification (Figure 8, Part 3) 

(AINSAKR) IS compared an element at a time to the arrays 

formed by students' answers (STDARR). From these 

comparisons the number of wrong answers to each question 

is computed and entered in the array RES. 



Lines 01-04: RESULTS is transmitted as exception output. 



Lines 05-06: A permanent error causes an error message to 
be written. 
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Transmit Interspersed with Receive (System/3 to OS or 
DOS Only) 

A "transmit interspersed with receive" program transmits 
data from one file and receives data in another; the data in 
the two files may or may not be related. Unlike conversa- 
tional programs, a "transmit interspersed with receive" 
program may intersperse data several records or several 
blocks at a time. 

The receive file must be defined as a Demand file on the 
RPG File Description Specification. The record available 
indicator must be defined on the RPG Telecommunication 
Specification. This method of transmission can be used 
only when System/3 is the remote terminal that initiated 
the transmission. When data is transmitted from the con- 
trol station, System/3 suspends its transmit file to receive 
the incoming data. 



Programming Considerations 

Once System/3 BSC has begun to process the last record in 
the BSCA transmit file, System/3 will ignore the record 
available indicator, whether or not the last record has 
actually been transmitted. When BSC accepts for trans- 
mission the last record in the file, RPG II completes LR 
processing and begins to close the file. 

This means that after RPG II passes the last record in the 
transmit file to BSC, RPG II completes Last Record (LR) 
processing and begins to close the file. Consequently, if 
OS or DOS requests to transmit a response to a record or 
block transmitted by System/3, the request is ignored if 
it is a response to the last record or last block in the file. 
If OS or DOS requests a response on the next-to-the-last 
record or block in the file, the request is ignored only if 
the file has already been closed. 

The System/3 programmer can avoid problems this may 
raise in a particular program by agreeing with the OS or 
DOS programmer upon a special record to be added to the 
end of the System/3 transmit file. Tliis record would signal 
OS or DOS that System/3 has gone to end-of-job and can- 
not honor a request to receive from OS or DOS, even though 
that request may have just been transmitted. 
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In Figure 9, a card file containing information about a stu- 
dent test is read in and transmitted to an OS or DOS for 
processing. During transmission, OS or DOS may interrupt 
to send back results. Wlien this occurs, RPG will turn on 
record available indicator 04. The input file is then read 
and the incoming data is printed on the printer. System/3 
then resumes transmission. 



Fiie Description Specifications (Figure 9, Part 1) 
Column Description 
7-14 RESULTS and GRADES are BSC files. 

15 RESULTS will receive data; therefore, it is 
an input file. GRADES will be transmitted 
and is an output file. 

16 To receive data intermittently, a BSC file 
must be a demand file. 

17 End-of-file on RESULTS does not determine 
end-of-job time. 

19 BSC files always have a fixed length format. 

20-27 Neither BSC file is blocked. 

40-46 BSCA is the device for BSC files. 
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Figure 9. Transmit Interspersed With Receive Program (No Conversational Reply) (Part 1 of 3) 
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Telecommunications Specifications (Figure 9, Part 2) 



32-47 Explicit station identification sequences are 

given. Station IDs ensure data security on tlie 
switclied network. 



Column Description 

7-14 RESULTS and GRADES are the BSCA files 

for this program. 

1 5 This station is part of a switched network (S). 

16 RESULTS is an input file and will receive 
data (R). GRADES is an output file and 
will be transmitted (T). 

17 Polling is not used, so column 17 is blank. 

18-19 EBCDIC code (E) and the transparency 

feature (Y) are both used. 

20-31 Autocall is used (E), and columns 21-31 

contain the dial number of the remote 
station. 



53-54 The permanent error indicator used is 44. 

55-57 The telecommunications line will be kept 

open for 70 seconds even though no mes- 
sages are being sent or received. After 70 
seconds have elapsed, a permanent error 
condition results if the line still is not being 
used. 

58-59 The record available indicator is 04. It is 

set on when the remote station is ready to 
send a record to be received by RESULTS. 



Input Specifications {Figure 9, Part 2j 

Lines 07-09: RESULTS receives records from the remote 
station. These records contain a student number and the 
student's score. Student scores are calculated by the remote 
station from the data transmitted from GRADES. 
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Calculation Specifications (Figure 9, Part 3} 
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Appendix A. ASCII and EBCDIC Codes 



The coded character sets for ASCII and EBCDIC are 
shown below. Use the set that your adapter and program- 
ming system supports. 



The data link control characters recognized by System/3 
are listed in Appendix B. 



ASCII Codes 







IVlain Storage Bit Positions 0, 1, 2, 3 


IVlain Storage 
Bit Positions 
4, 5, 6, 7 
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EBCDIC Codes 



Mam Storage Bit Positions 0, 1, 2, 3 



Main Storage 
Bit Positions 
4, 5, 6 7 •■ 



..^_.l:^L 



_j 



I 



1010 
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Appendix B. Data Link Control Characters 



[he lollovviiig characters and cliaracter sequences are 
recc)giii/ed b> S\steiii;3 BSCA. For detailed intornialioii 
on Data L,ink Control Characters, see Ceneral Iiijormatioii 
Binary Synchronous Coinniunications, C.A27-3()04. 



Njrne 

Stiirt of Heciiiing 

Stan of Texr 

End of Ti .ifismission Block 

Eznc) of Tox I 

End of Tijrismission 

Enquiry 

Negative Acknowledge 

Synchronous Idle 

Diita Link Escape 

Intermediate Block Character 

Even Acknowledge 

Odd Acknowledge 

Wan Before Tiansmit Pes. Ack. 

Mandatory Disconnect 

Reverse IntetrufM 
Ten-iporary Text Delay 
Transparent Start of Text 
Transparent Inteirnediate Block 
Transptireni End of Text 
Transparent End of Trans. Block 
Transparent Synchronous Idle 
Transparent Block Cancel 
Transparen' TTD 
Datti DLE in Trtmsparenf Mode 



Mneirionic 


ASCII 


EBCDIC 


SOH 


SOH 


SOH 
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STX 


STX 




ETB 


ETB 


ETB 




ETX 


ETX 


ETX 




EOT 


EOT 


EOT 




ENO 


ENQ 


ENO 




NAK 


NAK 


NAK 




SYN 


SYN 


SYN 




DLE 


DLE 


DLE 




ITB 


US 


lUS 




ACK 


DLE 


DLE (70) 


ACK f 


DLE f 


DLE/ 




WACK 


DLE; 


DLE, 




Disc 


DLE EOT 


DLE 


EOT 


RVI 


DLE < 


DLEC.t 


TTD 


STX ENQ 


STX 


ENO 


XSTX 




DLE 


STX 


XITB 




DLE 


lUS 


XETX 




DLE 


ETX 


XETB 




DLE 


ETB 


XSYN 




DLE 


SYN 


XENO 




DLE 


ENQ 


XTTD 




DLE 


STX 


XDLE 




DLE 


DLE 



DLE ENQ 
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Appendix C. Polling and Addressing Characters for System/3 



Polling and addressing are used on multipoint, nonswitched 
networks. Polling is a request to a tributary station to 
transmit data to the control station (central). Therefore, 
polling characters identifying your station must be entered 
on the RPG Telecommunications Specifications Sheet for 
the BSCA output (transmit) file. 

Addressing is a request from central to send data to your 
station. Therefore, the addressing characters must appear 
on the RPG Telecommunications Specifications Sheet for 
the BSCA input (receive) file. 



A polUng character is composed of two identical alphabetic 
characters; an addressing character is composed of two 
identical alphabetic or numeric characters. Polling and 
addressing characters must be used together in certain pairs. 
Wlien a polling character is selected, the complementary 
addressing character must be used; when an addressing 
character is selected, the complementary polling character 
must be used. 
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\ alid jiolliiiu aiRkuWiCNMiig ciiarLiLlciN ikU iioil; IHCDIC 
.iiid ASCII cude^ arc uivoii below in pair-,. 



ASCII CODE 



EB;CDICCODE 



Polling Character 


Addressing Character 






BB 


SS 


CC 


TT 


1)U 


i j l; 


f. t 


v' V 


F F 


WW 


'■.:y.} 


XX 


H \\ Y Y 


il 


zz 


J J 


il 


KK 


2'j 


LL 


33 


MM 


44 


I\jN 


bb 


00 


G6 


P? 


77 


OQ 


88 


HH 


99 



Polling Character i 


Addressing Character 


/A A 


da 


bB 


Ijb 


CC 


CC 


DD 


rid 


EE 


ee 





EF 


ff 


GG 


qq 


HH 


hh 




li 


II 




J J 


u 


KK 


kk 




LL 


il 


MM! 


!"ntTi 


(\1N 


nil 




OO 


OO 




?P 


PP 


QQ 


99 


RR 




SS 


SS 




T 1 


1 

! tT 

i 





UU 


UU 


VV 


1 VV 


WW 


WW 




XX 


XX 


V Y 


VV 


ZZ 


/z 



Appendix D. RPG II Teleprocessing Specifications Suitiinary 



RPG II TELECOMMUIMICATIONS SPECIFICATIONS 



(oliiniii Suhiccl 



iiitrv 



I'.xplcnialioii 



l^ 



41-4: 



Pai;c 

Line 

Porm I \ pc 

( umnicnls 

I'llc name 

('oiiliuuialioii 

I \ [1C of 

sUUlDIl 

!"> |X' ol 
control 

\\ pc of code 

1 iaiispaic!ic\ 
Swiichcd 

Dial luimlici" 



Location ol 
klcnliticalion 
\\]i>, slanon 

Idcnlilication 
tins station 

location ol 
idcntilication 
icniolc station 

Idcntirication 
rcniolc station 



1)1-'^) 
1 

.Alliliamcnc 

Poi blank. 
M.S 



A, r 

\ nr blank 



M. P. S. A. 
15, blank 

Nniiici ic, 
alpliarnci ic 

S. i:. blank 



S. P. blank 



I'agc nil 111 bet 

i_ inc inimbci 

Identities a teleconinitinication specifiealioi 

Idenlilies a coinmeni line 

Name of BSCA !ile 

Point tt) ponit, iioiisw itciied network, 
nuiltipoinl iieluoi k. sv\'ilclied network 

I ransmit oi recei\e (with or without 
coiueisalional lepK ) 

! iibutai \ slatHMt, noU'lribiitarx 



ASCII, (loimerh leleircrl to as LfS.\( II ), 
i IX DK 



A , \ or blank I raiisparencx' lealiire used or not used 



.Switched or not. manual or auto ansvver.c; 
location of dial iiimiber il autocall 

Dial numbei oi location ol dial number 



Location of 1 1) il II ) used 



.Alphameric II) en location ol II) il II) used 



location ol II) it' 1 1) Used 



.Alphameric ID oi location ol' ID li II) used 
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RPG II TELECOMMUNICATIONS SPECIFICATIONS (Continued) 



Column 



Subject 



Entry 



Explanation 



48-51 



Remote terminal 



Blank, 

2770,2771, 
2772, 2773, 
2774. 2780 



52 


1TB 


I, blank 


53-54 


Permanent 


01-99, 




error 


L1-L9,LR. 




indicator 


H1-H9 


55-57 


Wait time 


Numeric, 
blank 


58-59 


Record 


01-99, 




available 


L1-L9,LR, 




indicator 


H1-H9 



Columns 48-51 are used only if the Model 10 Disk 
System, Model 12, Model 15, or Model 6 is to 
communicate with an IBM 2770 or IBM 2780 (see 
Appendix E). Otherwise, columns 48-51 are never 
used with System/3 and must be blank. 

Intermediate block check used or not 
Signal of a permanent error 



Wait time specified or assumed 



Indicates that the receiving station is 
ready to transmit 



60 



Last file 



Identifies BSCA input file to be processed 
last 



61-62 



Polling 
characters 



Alphameric 



Polling identification 



63-64 



Addressing 
characters 



Alphameric 



Addressing identification 



65-70 



Remote device 



Blank, 1442-1, 
1442-2, 1443, 
0545-3, 0545-4, 
2213-1,2213-2, 
2502-1,2502-2, 
5496-1,5496-2 



Columns 65-70 are used only if the Model 10 Disk 
System, Model 12, Model 15, or Model 6 is to 
communicate with an IBM 2770 or IBM 2780 (see 
Appendix E). Otherwise, columns 65-70 are never 
used with System/3 and must be blank. 



71-74 
75-80 



(Reserved) 

Program 
identification 



Alphameric 



Not used 

Name of program 
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FILE DESCRIPTION SPECIFICATIONS FOR BSCA FILES 



Column 


Subject 


Entry 


Explanation 


7-14 


File name 


Alphameric 


Name of BSCA file 


15 


File type 


1,0, C 


Input (receive), out 



bined (conversational); C is invalid with 
an IBM 2770 or IBM 2780 



16 


File 


D 




designation 




17 


End of file 


E, blank 


19 


File format 


F 


20-23 


Block length 


Numeric 



Demand file for transmit interspersed with 
receive or for any other use of READ with 
a BSCA file 

End-of-file used to determine end-of-job 
time 

Fixed length 

Block length of BSCA file (same as record 
length for conversational reply); see Ap- 
pendix E for entry with IBM 2770 or IBM 
2780 



24-27 



32 



40-46 



Record 


Numeric 


length 




Additional 


1-9, blank 


area 





Device 



BSCA 



Length of BSCA records; see Appendix E 
for entry with IBM 2770 or IBM 2780 

Dual or single I/O area; dual for non- 
conversational BSCA files only 

Device for all BSCA files 
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Appendix fE. Using the IBM 2770 and the IBM 2780 



RPG II telecommunications programming supports the 
IBM 2770 Data Communication System and the IBM 
2780 Data Transmission Terminal as remote terminals for 
the Sysiem/3 Model 10 Disk System, Model 12, Model 15, 
and Model 6. This appendix contains a description of the RPG 
II specifications required to use the IBM 2770 and the IBM 
2780, a discussion of specific System/3 considerations 
which apply when using these devices, and one sample 
RPG II program for each device. 

Nate: Before attempting to write your own RPG II pro- 
grams for using the IBM 2770 or the IBM 2780, you should 
xfddi IBM Systems Reference Library -System Components: 
IBM 2770 Data CommunieatUm System. GA27-3013; IBM 
Systems Reference Library -IBM 2770 System Summary. 
GA27-301 4; and/or IBM Systems Reference Library-IBM 
2780 Data Transmission Terminal-Component Descrip- 
tion. G A 27-3005. 

RPG II SPECIFICATIONS 

Use of the IBM 2770 Data Communication System and the 
IBM 2780 Data Transmission Terminal affects RPG file 
description specifications, RPG line counter specifications. 
RPG telecommunications specifications, and RPG output- 
format specifications. Only the entries unique to the IBM 
2770 or IBM 2780 are described here. 



When transmitting to an IBM 2780, no more than two 
records are blocked if the ratio of block length (columns 
20-23) to record length (columns 24-27) is less then 2. If 
the ratio is greater than 2. no more than 7 records will be 
blocked. 

The IBM 2770 inserts a record separator (RS) character be- 
tween blocked records, but does not perform intermediate 
block checking. If you specify 1TB for the IBM 2770 in 
transparent mode, Syslcm/3 issues a diagnostic. Otherwise, 
the specification is ignored for the IBM 2770. Intermediate 
block checking is always assumed for the IBM 2780. 

For record lengths supported by the remote devices you 
are using, see the appropriate Systems Reference Library 
manual. 

If a record received by System/3 is shorter than the record 
length specified in columns 24-27. blanks are added to the 
right. If a record received by System/3 is longer than the 
record length specified in columns 24-27, the record is 
truncated on the right. 



Columns 33-34 (Overflow Indicator) 

An overf ow indicator may be specified Itir IBM 2770 and 
IBM 2780 printer files. 



RPG File Description Specifications 

For each IBM 2770 or IBM 2780 device specified on the 
RPG Telecommunications Specifications sheet (see RPG 
Telecommunications Specifications), a unique file must be 
defined on the RPG File Description Specifications sheet. 

Columns 20-27 (Block Length and Record Length) 

The Systeni/3 block length (columns 20-23) and record 
length (columns 24-27) determine the remote bufTer size. 
For the IBM 2780, buffer size is always 400; for the IBM 
2770, tlie butler size is as follows: 



Columns 40-46 (Device) 

The device specified in columns 40-46 of the RPG File 
Description Specification sheet is always BSCA for each 
IBM 2770 and IBM 2780 file. The maximum number of 
files allowed within a program using BSCA files is 1 2. 



Other Entries 

All other valid file description specifications are accepted 
in a BSC program using the IBM 2770 or IBM 2780. 



Systetn/3 Block Size 



Remote Buffer Size 



<-|28 
>128 



128 
256 



Telecommunications RPG II support then blocks all records 
to ensure that the remote buffer size is never exceeded. 
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RPG Line Counter Specifications 

A line counter specification should be given for every IBM 
2770 and every IBM 2780 printer file. If a line counter 
specification is not given, the overflow line is set at 60 and 
the form length is set at 66. A warning is issued at com- 
pilation time for each IBM 2770 or IBM 2780 printer file 
lacking a line counter specification. 



RPG Telecommunications Specifications 

IB.M 2770 files and IBM 2780 files require two additional 
entries on the RPG Telecommunications Specifications 
sheet: Remote Terminal and Remote Device. 



Columns 48-51 (Remote Terminal) 

l-Mtiy lixplaiiarion 

2770 The remote terminal is an IBM 2770. If 
Systeni/3 is transmitting, the output channel 
on the IBM 2770 is, by default, output chan- 
nel 1. 

2771 The remote terminal is an IBM 2770, output 
channel I . 

2772 The remote terminal is an IBM 2770, output 
channel 2. 

277.1 The remote terminal is an IBM 2770, output 

channel 3. 

2774 The remote terminal is an IBM 2770, output 

channel 4. (Output channel 4 is an optional 
channel; if it is not available and is specified, 
a permanent error occurs.) 

2780 The remote terminal is an IBM 2780. 

Xotc: You cannot specify both the IBM 2770 and the 
IBM 2780 in the same program. 



Columns 65-70 (Remote Device) 

I'Mtry Remote Terminal Remote Deviee 

1442-1 IBM 2780 IBM 1442 Card Read/ 

Punch (card read) 

1442-2 IBM 2780 IBM 1442 Card Read/ 

Punch (card punch) 



1443 IBM 2780 

0545-3 IBM 2770 

0545-4 IBM 2770 



2213- 1 



IBM 2770 



3-2 IBM 2770 



2502-1 IBM 2770 



2502-2 IBM 2770 



5496-1 IBM 2770 



5496-2 IBM 2770 



IBM 1443 Printer 

IBM 0545 Card Punch, 
Model 3 

IBM 0545 Card Punch, 
Model 4 

IBM 221 3 Printer, 
Model I 

IBM 2213 Printer, 

Model 2 

IBM 2502 Card Reader, 
Model 1 

IBM 2502 Card Reader, 
Model 2 

IBM 5496 Data Re- 
corder (card read) 

IBM 5496 Data Re- 
corder (card punch) 



Before transmitting data from System/3, the System/3 pro- 
granmier must detcrmme which output channels and/or de- 
vices are necessary to his program, and ensure that they will 
be available when required. Device selection occurs each 
time a different file is selected. 



Related RPG Telecommunications Specifications 

A designation of multipoint (M in column I 5) and associated 
entries (T in column 17, addressing and polling characters in 
columns 61-64) are invalid Telecommunications Specifica- 
tions entries in a program using the IBM 2770 or IBM 2780. 
System/3 can not function as the control station in a multi- 
point network. 

All other Telecommunications Specifications entries are 
valid in a program using the IBM 2770 or the IBM 2780. 
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RPG Output-Format Specifications 

Space and skip enlnes are restricted bv tiic IBM 2770 and 
IBM 2780 as follows: 

• An entry of or blank is not supported in column 18 
(Space After): default is to space 1 after. 

• The skip entry is limited to a maximum of 1 1 2 for the 
IBM 2213 Printer. Model 1 (see your system RPG II 
reference manual to enter 100-1 12). 

• Tape carriage channel control is not supported (contine 
punches to cliannel 1 ). 

• Repeated IP forms positioning cannot be used on the 
IBM 2770 and IBM 2780. 



Related Considerations 

m The IBM 1443 Printer spaces once each lime it is sel- 
ected tor the IBM 2780. 

• An escape character (X'27") must not be the first byte 
sent to the IBM 2780 printer if you arc transmitting in 
transparent mode. 

• Each printer for the IB.M 2770 and IBM 2780 resets the 
internal line count to 1 if the print file is reopened after 
a punch file has been transmitted to an IBM 2770 or 
IBM 2780. 

• The end-of-file card transmitted by the 54% Data Re- 
corder from the IBM 2770 is received by System/3 as 
data. 

• System/3 cannot print the end-of-media character trans- 
mitted by the IBM 2780. Translate this character to 
avoid an unprintable-character halt on Systeirr/3. 



SYSTEM/3 CONSIDERATIONS 

The S>stem/3 RPG 11 programmer must constantly be 
aware of the limits imposed by the IBM 2770 and the IBM 
2780 when they are used as remote terminals. For that 
reason, a thorough reading of the following manuals is im- 
perative: 

• IBM Systems Reference Library -System Components: 
IBM 2770 Data Conwmnieation System, GA27-3013. 



• IBM Systems Reference Library- -IBM 2770 System 
Summary. GA27-30I4. 

and/or 

• IBM Systems Reference Library IBM 2780 Data Trans- 
mission Terminal-Component Description. GA27-3005 

The Systcm/3 programmer must also consider: 

• Transmit with conversational reply and receive with con- 
versational reply are not supported with the IBM 2770 
or the IBM 2780. 

• Transmit interspersed with receive is not supported with 
the IBM 2770 or the IBM 2780. 

• If System/3 answers an IBM 2770 or an IBM 2780 in a 
switched network, the first file referenced by System/3 
cannot be a transmit file. Use a dummy receive file to 
acconmiodate your particular needs if System/3 cannot 
always be programmed to call. 

• Without the auto-turnaround feature, the IBM 2780 
usually cannot transmit to System/3 and then, immedi- 
ately after the data has been transmitted, receive from 
System/3. The IBM 2780 operator cannot, in most cases, 
ready devices to receive in the short time required by 
System/3 to turn the line around from receive to trans- 
mit. In the absence of auto-turnaround, program Sys- 
tem/3 to transmit and then receive. 

• Spacing and skipping in transparent mode usually requires 
more transmission time if an IBM 2770 or an IBM 2780 

is the remote terminal: 

IBM 2770 To space or skip more than one line re- 
quires an escape sequence (command to 
printer) to be transmitted in nontrans- 
parent mode (executed by RPG 11). This 
entails line turn around time and extra 
transmission time. 

IBM 2780 — To space or skip more than three lines 

requires an escape sequence (command to 
printer) to be transmitted in nontrans- 
parent mode (executed by RPG II). This 
entails line turn around time and extra 
transmission time. 



tMns; thf IBM 2770 and llic IliM 2781 



59 



EXAMPLES 

The foUovi/ing two RPG 11 programs provide examples of 
ihe Systern/3 Model 10 Disk System or Model 12 using (he 
IBM 2770 and the IBM 2780 as remote terminals. Tlie ilrsi 
program transmits data from System/3 to an IBM 2770: the 
second controls the transmission of dala from an IBM 2780 
to System/3. 



Transmitting to the iBM 2770 Data Communication Sys- 
tem 

Systcm,'3 reads lite inpiii ille., CARDIN. from MFCLII 
(Figure 10). This data forms ilie output file, FUTONLY, 
Ilia! IS iransmitted. using the BSCA, to an IBM 2770. 
Transmission is in nontrjiisparent mode. 

The IBM 2770 prims PUTONLY on an IBM 2213 Primer. 
-Model 1. PLJTONL.Y is luinied with a heading conditioned 
on ihe overflow line. 
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Receiving from an IBM 2780 Data Transmission Terminal 

Ail IBM 27'SO I -Kb, an input riicCrTO^i ^\ r. ri .- IBM 
1442 Cam Read Punch (Figure 1 i ). Sysieir 3 iiiHiaUv. 
the (iperatioii by dialiiiii the IBM 2780 aiin :auuestiiig Ui 
reeeive using ine BSC'A, ilie IBM 27.-;() liien ivanMiiiis 
(;i.lON!_V to Sysiem 3 in nuntranspaieni niode. 

Data received by Systeni/3 from the IBM 2780 lorni^ iiie 
output file PRINT. Systcni/3 print-, thi> fiie. spacing once 
alter eacli record. 
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Appendix F. Communicating with the Operating System Telecommunications Access iViethod (TCAM) 



^>'^''-''"'-' ^''i" be part of a lelecommuiiicalioiis network that liisicad of using one combined file for transmiiiing and re- 

mcludes the Operating System Teleeoniinunications Access ceiving data, the RPG II technique requires two fil'^.is; a de- 

Meihod (TCAM). (For nifornialioii regarding TCAN4, see maiid file for input from the BSCA, and another file for oui- 

IBM Sv.srciii:360 Opcnituig System Televoiiunuiucahofis put to the BSCA. 
Access Metiicd (TCAMj Concepts and /'acili/ies. GC30-2022, 

and IJ]M Sv\/cni Jfiii Openitiiii: Svsh'iii Tclcccnuiniiniealions riie lollowing two sample programs use the RPC, I] tech- 

.'.'.(■('vv Mciiind tTCAM : l'ri>;^nin!iiier's (hiide and Rcjcrence nique to approximate conversational mode. System/.? is 

Manual. (iC.t()-2024.) the prhiiary station in tiie llrst sample program (System/3 

initiates transmission to TCAM); System/3 is the remote 

Syslem/3 communicates witii TCAM in the same way it station in the second sample program (TCAM initiates trans-^ 

commi nicates with aiunhci System/3 except tiiat it cannot mission to Systein/3). 
exchange conversational messages with TCAM. Th.e System/3 
programmer may only approximate conversational mode by 
using RFC, II. 

The RPC II technique i\)r approximating conversational 
mode consists ol'; 

• Using the RH.AD operation code to receive data and I he 
EXCiPT operation code to transmit data. 

• Indicating a transmit or a receive operation via TC'\M to 
the Systeni/3 progiam so that Systeni/3 will perform 
the appropriate BSCA transmit or receive operation. 
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SYSTEM/3 TO TCAM 



Extension Specifications 



System/3 transmits to TCAM (Figure 12) the answers (Y or 
N) that students have given on a test. TCAM determines 
which answers are correct and whicli are not. and then re- 
turns the results to System/3. 



MFC] TAB contains the tables TABME and TABYOU. 
TABME is the System/3 station ID; TABYOU is the TCAM 
station ID. 



File Description Specifications 

System/3 reads student answers from MFCUl. The 
answers will be transmitted to TCAM. MFC 1 TAB is a 
table file containing station ID's. ANSWER and RESULTS 
are used to transmit and receive, respectively. RESULTS 
must be a demand file (D in column 16) because the READ 
operation code will be used to receive records to the file. 
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Telecommunications Specifications 



Input Specifications 



ANSVVl- RS ijiid RLSULTS arc nansnui aiui icccive iilcs, 
icspeclivcij. . Both are pun ofa switched iieivvork. 



MFCIM provides data trom the card reader. RESULTS 
provides data I'lom TCAM. 
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Calculation Specifications 



Output-Format Specifications 



Systeiii/i recoids the iiumbei- ol tosiN n:iiisiiii! icd \') U' \M 
lor coiicctiui! The lesis are iransiniiicd hv oxecpiioii diii- 
pill to ilic BSCA. Syslem/3 icceives (iisint; iJie Rh.AiJ 
operation ctxle) results iVom I'CAM iiiiiil .Svs!eni;3 leaches 
end-of-nie on Rl'.SULTS. Syslem/3 sets iihlica.iois oil at 
erul-of-rije lime to prepare lor ilic next KPt , e\'cle. 



Svsiem,/3 prints ilala by cxeeption output as the data is 
lead from ilie eard reader and received from the BSCA. 
System/3 Iransniiis data to TCAM by exception output as 
tile dala is read from the card reader. Sysiem/3 signals 
K AM (with an '!:') when no more records will be sent. 
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TCAM TO SYSTEM/3 



Extension Specifications 



System/3 receives from TCAM (Figure 13) the answers (Y 
or N) that students have given on a test. Systcm/3 deter- 
mines which answers arc correct and wliich are not. and 
then returns the results to TCAM. 



File Description Specifications 



Ttie first record from MFCL!) contains station ID"s. The 
second record from MFCUI is a table. MAST, containing 
the correct answers for the tests lo be processed. Tvvo 
arrays. ANS and RFS, will be built dming execution of the 
program. ANS will contain answers received; RFS will con- 
tain the results of a comparison of the answers received to 
the ct)rrect answers in MAST. 



MFCDUMY is a dummy file and serves only to begin the 
RPG 11 cycle, MFCUI is a table file, containing station 
id's and a table of the correct answers for the tests being 
processed. ANSWFRS and RESULTS are BSCA files used 
to receive and transmit, respectively. ANSWERS must be 
a demand file (D in column 16) because the READ opera- 
tion code will be used to receive records to the file. 
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Telecommunications Specifications 



Input Specifications 



ANSWERS and RESULTS are receive and transmit files, 
respectively. Both are part of a switched network. 



ANSWERS receives data from TCAM. The character 'E' 
will identify the last record to be received (columns 26-27), 
MFCDUMY contains no data but merely begins the RPG II 
cycle and sets on indicator 39. 
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Calculation Specifications 

After reading MFCDUMY, System/3 receives a record to 
ANSWERS, prints the record received (by exception out- 
put), determines which of the answers received are correct 
{by comparing them to the answers in MAST), and then 
prints and transmits the resuhs (by exception output). 
After each record has been processed, System/3 prepares 
for the next RPG II cycle by setting olf indicators. 



Output-Format Specifications 

Systcm/3 prints and transmits data by exception output. 



System/3 continues to receive and process answers until 
the last record, identified by "E\ has been processed. 
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TCAM CONSIDERATIONS 

Two resiriclions nut aiiparcnl in the piecctlinii c\aiiipk-s 
must bf considered wiien \ on eonimunieale vvilii "IX -W'l; 

L To avoid "unidenlilicd lecord" halis, yoiit RI'd II 
|iiOi;raiii must leeogui/e and iiuiore am 'liank reeijtds 
trans. iiiiied bv TCAM. (Tt'AM may iransmi; loyou 
biank reeords received !iom ilsoiiiei Iti miiiais. ) 
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Appendix G. Using the IBM 3741 and IBM 5230 



RPG II telecommunications programming supports the 
IBM 3741 Model 2 Data Station, the IBM 3741 Model 4 
Programmable Work Station, and the 5230 Model 2 Data 
Collection Controller in communicate mode as a remote 
device via the BSCA on the IBM System/3 Model 6, 
Model 8, Model 10 Disk System, Model 12, and Model 15. 
The 3741 and 5230 are also supported when locally attached 
to the System/3 Model 6, Model 10 Disk System, and 
Model 15 via the Local Communications Adapter. In 
addition, remote and local attachment is supported via 
the Integrated Communications Adapter on the IBM 
System/3 Model 8 and Model 12. 

This appendix contains a description of the RPG II 
specifications required to use the 3741 and 5230 
(identical to specifications used to receive from a 3741 
without expanded communications) and three sample 
RPG II programs. 

It is recommended that only one data set be transmitted 
from the 3741 during the execution of an RPG II pro- 
gram. If more than one data set is transmitted, erroneous 
records may be passed to the RPG II program. Data sets 
with different record lengths are not permitted, since 
only one BSCA input file can be defined. 

For more detailed explanation of transmitting data sets 
on 3741 , refer to the IBM Systeml3 3741 Models 3 and 4 
Programmable Work Station Programming Reference 
Manual, GA21 -91 94, or IBM 3741 Data Station Reference 
Manual, GA21-9183. 

A 3741 with an Expanded Communications Feature (Fea- 
ture 1 680) has a maximum buffer size of 5 1 2 bytes. 

The Operator Identification Card Reader Feature (Feature 
5450) and the Expanded Communications/Multipoint Data 
Link Control Feature (Feature 1685) on the 3741 are not 
supported by System/3 RPG II. 

Note: If an RPG II program is communicating with a 3741 
and an error occurs on the 3741 , the System/3 could loop 
on I/O attention. To prevent this, the RPG II program must 
use the permanent error indicator to force the application 
program to end of job or other non-BSCA operations. The 
user program should print a message if this occurs. 



RPG II SPECIFICATIONS 

Use of the IBM 3741 affects RPG II file description 
specifications, RPG II telecommunications specifications, 
and RPG II output format specifications. Only the entries 
unique to the 3741 are described here. 

RPG II File Description Specifications 

Only two BSCA files are allowed (one input and/or one 
output) per RPG II program. If two BSCA files are used, 
the input file must be processed completely before pro- 
cessing the output file. 



Column 15 (File Type) 

Entry Explanation 

I This is an input (receive) file. 

This is an output (transmit) file. 

Columns 20-23 (Block Length) 

When using an RPG II program to communicate with a 
3741 without the expanded communication feature, the 
maximum block length is 128 bytes. 

When using an RPG II program to transmit to a 3741 with 
the expanded communications feature, the maximum 
block length is 512 data bytes plus a number of IRS 
(interrecord separator) characters equal to the blocking 
factor. The IRS characters are stripped by 3741 hard- 
ware so the block will fit into a 512-byte buffer. When 
using an RPG II program to receive data from a 3741 
with the expanded communication feature, the maximum 
block size is 5 1 2 bytes. This block contains the data 
records as well as the record separator characters placed in 
the 3741 buffer before transmission. The RPG II program 
may remove or ignore the IRS character. See Expanded 
Communications Feature in the IBM 3741 Data Station 
Reference Manual, GA2 1-9183. 

Note: When the 3741 is in ECB transmit mode (J) it 
will block records, including the IRS characters, to get 
the maximum number of records into a 5 1 2-byte buffer. 
An X'lE' must be used as the IRS character when 
transmitting to the 3741 (see Figures 16 and 18). 
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Columns 24-27 (Record Length) 

Maximum record length is 128 data bytes (129 bytes, which 
includes the IRS character, if expanded communications 
feature is used). 



Columns 40-46 (Device) 

BSCA is specified when 3741 attachment is via either the 
Binary Synchronous Communications Adapter or the 
Local Communications Adapter. 



RPG II Telecommunications Specifications 

The 3741 files require some restrictions to the telecom- 
munication specifications. Only the columns affected are 
listed here. 

Column Entry Not Allowed Description 



15 


M 


Multipoint network 


17 


T 


Tributary station on a 
multipoint network 


18 


A, U 


ASCII 


19 


Y 


Transparency (Not 
allowed when the 
3741 is attached via 
the Local Communica- 
tions Adapter) 



52 



ITB 



Columns 61-74 must be blank. 

RPG II Output Format Specifications 

Columns 17-22 must be blank. 
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Transmitting to the IBM 3741 



The following RPG II programs provide examples of the 
System/3 Model 10 Disk System, System/3 Model 12, and 
System/3 Model 15 using the 3741. The first program 
transmits data from the System/3 to a 3741, the second 
program receives data from a 3741 , the third program 
transmits data to a 3741 with the expanded communica- 
tions feature using the expanded communications buffer, 
and the fourth program receives data from a 3741 Model 2 
and receives a status message. 



System/3 reads the input file CARDIN from MFCUl 
(Figure 14). This data forms the output file BSCAOUT 
that is transmitted, using the BSCA, to a 3741. The 3741 
writes the data on a diskette. The printer file is used to 
indicate normal end of job and any errors. 
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Receiving from an IBM 3741 

The IBM ,3741 transmits a record using ilie BSCA to 
System/3, Tliis data forms the input Hie BSCAIN, Tlie 
System; 3 'A'rites tiie data icccivcd to the printer file 
PRlNTLRt Figure LS). 
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Transmitting to a 3741 with Expanded Communications 
Feature 

This program (Figure 16) shows the BITON and BITOF 
coding needed to generate the interrecord separator 
character to separate records when transmitting data to a 
3741 using the expanded communications feature. 

System/3 reads the input file DISKA from DISK. The RPG 
II program will then attach an IRS (interrecord separator) 
character to each record in this file. This forms the output 
file T374] which is then transmitted, using BSCA, to a 
3741. The PRINT file is used to indicate any errors and 
a total card count at end of job. 
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Appendix H. Using RPG II in Communications Between a System/3 and the IBM 3750 

(World Trade Only) 



When a System/3 is connected to an IBM 3750 Switching 
System, the RPG II telecommunication program must be 
used to code the application programs allowing message 
exchanges between the two systems. The application 
program can be written for message exchange related to 
the following 3750 functions: 

1. Call recording 

2. Contact monitoring under data processing system 
control 

3. Inquiry to data processing system with recorded 
answer 

4. Real time data collection to data processing system 

5. Recorded announcement to extension under data 
processing system 

6 Transfer of recorded data to data processing system 

Communications between the System/3 and the 3750 are 
binary synchronous, point-to-point operations in trans- 
parent mode. Only the EBCDIC code can be used. The 
System/3 operates as a transmit and receive station. 



Programming Procedure 

On each end of file (EOT) received from a file, the RPG II 
program must switch to read the other input file. 

1. The input files will be defined as receive files on the 
RPG II telecommunications specifications. 

2. The output file will be defined as a transmit file on 
the RPG II telecommunications specifications. 

3. The exit from the RPG II program can be taken 
when the stop message is received. 

4. The remot device field of the RPG II telecommuni- 
cations specification must be left blank. The 3750 
is considered to be a processor by System/3 RPG II 
BSCA. 
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Appendix I. System/3 RPG II Interface to BSC Line Protocol 



This appendix is intended for a person who is knowledge- 
able about BSC line protoeol. This person should have the 
following information to: 

• Write a program for the remote loeation to interfaee 
with System/3 RPG II 

• Write a program for the System/'3 to perlorm a specific 
sequence of line protocol 



Note: During the execution of an RPG 11 telecommunication 
program, BSC output data management delays transmission 
of each block of data until the next block is ready to be 
transmitted. This delay is necessary to allow data management 
to place the proper line control character (ETX) on the last 
block of data to be transmitted. For example, the Transmit 
Multiple Files ciiart shows the last data block of file I being 
transmitted as a result of the user program requesting output 
to BSC file n. 



The appendix shows RPG 11 Binary Synchronous Communi- 
cations (BSC) line protocols and indicates which ones are 
performed automatically and which ones the RPG 11 
program controls. 

Each System/3 transmission of data over the communica- 
tion line is equal to BLOCK SIZE on the BSCA's File 
Description Specification. The size of the data blocks receiv- 
ed by Sysiem/3 is controlled by the transmitting station. 
(The asterisk in the Sysiem/3 Software/Adapter column 
indicates customer coding logic.) 



System/3 


Transmitting Station 


System/3 Software/Adapter 


ACK M^ 


•^^ ENQ 


Lnie initiahzatioo (automatic) 


ACK ^^ 
ACK m^^ 


■^^^ Data 
■^^^ Data 


' 1 nput froiTi BSC file 
(automatic acknowledge) 




-^mm EOT 


" Causes end of file for BSC file 



Systeni/.l RP(; II Inlcrtacc lo BSC Line Prolocol 9.^ 



Transmit 



System/3 


Receiving Station 


System/3 Software/Adapter 

_ 


ENQ ■■► 

-^^ ACK 


1 , 

Line initialization (automatic) 


E 
Data T mm^- 
B 

' ~~~ V— -~— J^^" ^CK 

E ~~ — -__]][]^~~~ -^ Ir— — _ 

B ' ~ 
-^^ ACK 


*Output to BSCtile 
(automatic acknowledge) 


E 
Data T ^^^ 
X 

-^^ ACK 


*End of job 
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Transmit Multiple Files 



System/3 



Receiving Station 



System/3 Software/Adapter 



ENQ 



E 
Data T 



E 

Data T 

X 



EOT 
ENQ 



E 

Data T 

B 



E 

Data T 

X 



EOT 



ACK 




ACK 



ACK 



ACK 



ACK 



ACK 



Line initialization (automatic) 



'Output to BSC fik; 1 
(automatic acl<novvleclgt; 



' Output to BSC file /) 
(automatic acl<novvleci(jt;) 



Line initialization (automatic) 




EikI of lol 



Sxsicm 3 RFC. II Inlcilacc !>> BSC 1 mc I'ioukoI 45 



Transmit/Receive 



System/3 


Receive/Transmit Station 


System/3 Software/Adapter 


ENQ mt^ 




Lull.' initial i/ation (automatic) 




^ ACK 




E 
B 




'Output ti) BSC fiti.' 1 
(automatic acl<iiovvlc(ji](:) 




■^- ACK 




E^ 

Data T ""^ 
B 


^" ACK 




E 
X 


^■" ACK 


■ liiiXit ftoiTi BSC lilc /; 
(automatic acl< now li'dcjc 1 


-^ 








"^^ ENQ 


Line initiali/atioi'i (automatic! 


ACK m^^ 


^ o.„ 




ACK^-^^ 








^■» Data 




ACK H^- 






^ .0. 


'Causes end of file foi BSC file 
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Receive/Transmit 



System/3 


Transmit/Receive Station 


System/3 Software/Adapter 




^ E«a 


Line initialization (automatic) 


ACK -► 








■^^^ Data 


■ ln()ut fiom BSC file 1 
(automatic acknowlecige) 


ACK -i^ 






\:^X^^^^^^ 


^^.r'^Z^^^ 




ACK ^^ 








^^ EOT 


"Causes end of file for BSC file 


ENQ ~^ 




"Output to BSC file n 




•4^Mi ACK 


(automatic acknowledge) 


E 




Line initialization (automatic) 


Duta T ^^ 






B 






r~~~^^^A^^^^^ 


•^^■^ ACK 




E 






Data T "^^ 






B 


^ .CK 




E 






Data T h^- 




* End of |ob 


X 


^ .CK 




EOT mm^ 
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LEASED MULTIPOINT, SYSTEM/3 TRIBUTARY STATION 

Receive 



Svstem/3 


Control Transmitting Station 


System/3 Software/Adapter 




•^^" Addrset/ ENQ 


Line initialization (automatic) 


ACK ^^ 










* Input from BSC file 




•^^^ Data ^,—-'-'\^^\i'--^ 


(automatic acknowledge) 


ACK M^ 


"^f^ Data 




ACK M^' 










*Causes end of file for BSC file 




<4^ EOT 
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Transmit 



System/3 



E 

Data T 



E 

Data T 
X 



EOT 



Control Receiving Station 



Polling seq ENQ 



ACK 



ACK 



System/3 Software/Adapter 



Line initialization (automatic) 




"Output to BSC file 
(automatic acknowledge) 



" End of job 
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Transmit, Receive 



System/3 


Control Receive/ 
Transmit Station 


System/3 Software/Adapter 


-^^" Polling seq ENQ 


Line initialization (automatic) 


E 
Data T "^^ 
B 

~\~- --_____j^^M ACK 

E ^------____3I~~ ~~~i/ 

B 


"Output to BSCfile 1 
(automatic acl<nowledge) 


E 
Data T ""^ 
X 

•^^" Addr seq ENQ 
■^^^ Data 

— v-~2llil^^^^— ----"" — — '^^ — " 

. \^ ^^^ Data 

ACK ""^ 


•input BSC filen 
(automatic acl<nowledge) 

Line initialization (automatic) 


^ .OT 


'Causes end of file for BSC file n 
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Receive, Transmit 



System/3 



ACK 



ACK 



E 

Data T 

B 



E 

Data T 

X 



EOT 



Control Transmit/ 
Receive Station 



Addrseq ENQ 



EOT 



Polling seq ENQ 



ACK 





System/3 Software/Adapter 



Line initialization (automatic) 



Input from BSC file 1 



*Causes end of file for BSC file 1 



*Output to BSC file/7 
(Automatic acknowledge) 

Line initialization (automatic) 



* End of job 
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POINT TO-POINT SWITCHED LINE 

ID SEQ: SWITCHED LINE STATION IDENTIFICATION SEQUENCE OPTIONAL 

Receive, System/3 Answer Station 



System/3 


Transmit Station 


System/3 Software/Adapter 


•^^ IID secil ENQ 
[ID seql ACK ""i^ 


Line initiali/'ation (automatic) 


•^^■i Data 
ACK mJ^ 


' Input from BSC file 
(automatic acknowledge) 


•^^ DLE EOT 


"Causes end of file for BSC file 
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Receive, System/3 Calling Station 



System/3 



[IDseql ENQ 



EOT 



ACK 



Transmit Station 



[IDseq] ACK 



ENQ 



Data 




System/3 Software/Adapter 



Line initialization (automatic) 



* Input from BSC file 
(automatic acknowledge) 
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Transmit, System/3 Answer Station 



Svstem/3 


Receive Station 


System/3 Software/Adapter 


•^M [ID seq] ENQ 
[ID seql ACK ^i^ 

■^n^ EOT 


Line initialization (automatic) 


E 
Data T ""i^ 
B 

r~-~M^ ' — ' — ^— — — .j*^^ ^^^ 

E ^~ -_]]][~~ ~-l/^-^_ 

Data T iBi^ ~~ ~ V— — — ^ 

B 


'Output to BSC file 
(automatic acknowledge) 


E 
Data T ^^^ 
X 

OLE EOT ^^ 


* End of job 
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Transmit, System/3 Calling Station 



System/3 


Receive Station 


System/3 Software/Adapter 


[ID seql ENQ m^^ 

-^^ [ID seq] ACK 


Line initialization (automatic) 


E 
B 

E ' ~— -~IIII~~^^'' 

Data T bi^ V — — 

8 

•^i" ACK 


"Output to BSC file 
(automatic acknowledge) 


E 
X 

-^HB ACK 
DLE EOT mn^ 


*End of job 
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Transmit/Receive, System/3 Calling Station 



Svstem/3 



Receive/Transmit Station 



System/3 Software/Adapter 



[ID seql ENQ 



E 
Data T 



E 

Data T 

X 



EOT 



ACK 



ACK 



ID seql ACK 



ACK 



ACK 



ENQ 



Data 



DLE EOT 



Line initialization (automatic) 



'Output to BSC file 1 
(automatic acknowledge) 





* Input from BSC file n 
(automatic acknowledge) 



Line initialization (automatic) 



'Causes end of file for BSC file n 
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Transmit/Receive, System/3 Answer Station 



System/3 



I ID seqi ACK 



ENQ 



E 
Data T 



E 

Data T 

X 



EOT 



ACK 



ACK 



Receive/Transmit Station 



;iD seql ENQ 



EOT 



ACK 



ACK 



ACK 



ENQ 



Data 



DLE EOT 





System/3 Software/Adapter 



Line initialization (automatic) 



'Output to BSC file 1 
(automatic acknowledge) 



' Input from BSC file n 
(automatic acknowledge) 



Line initialization (automatic) 



'Causes end of file for BSC file n 
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Receive/Transmit, System/3 Answer Station 



Svstem/3 


Transmit/Receive Station 


System/3 Software/Adapter 


-^^ [ID seql ENQ 
IID seqi ACK ™^ 


Line initialization (automatic) 


•^^M Data 
ACK ^^ 


* Input from BSC file 1 
(automatic acknowledge) 


^ EOT 


'Causes end ot file for BSC file 1 


<^M ACK 
E 
B 

-^mm ACK 


'Output to BSC file n 
(automatic acknowledge) 

Line initialization (automatic) 


E 
X 

DLE EOT Hi^ 


' End of job 
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Receive/Transmit, System/3 Calling Station 



System/3 



Transmit/Receive Station 



System/3 Software/Adapter 



[ID seql ENQ 



EOT 



ACK 



ACK 



ENQ 



E 
Data T 



E 

Data T 

X 



DLE EOT 



IID seql ACK 



ENQ 



Data 




EOT 



ACK 



ACK 



ACK 



Line initialization 
(automatic) 



' Input from BSC file 1 
(automatic acknowledge) 



'Causes end of file for BSC file 1 



'Output to BSC file n 
(automatic acknowledge) 

Line initialization (automatic) 




'End of job 
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CONVERSATIONAL MODE 
Receive with Conversational Reply 



System/3 Receive 


Transmitting Station 


System/3 Software/Adapter 


ACK HH^ 


Line initialization 
(automatic) 


E 

•^M DATA T 

X 

X 


*lnput BSC file 
(automatic acknowledge) 


E 
DATA T mm^ 
X 

■^m ACK 


*Output conversational response 
(automatic acknowledge) 


T T ^i^ 
X X 

E 

•^^ DATA T 

X 

X 


*lnput BSC file 
(automatic acknowledge) 


^.0. 


*Causes end-of-file on BSC file 
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Transmit with Conversational Reply 



System/3 Transmit 



ENQ 



DATA T 
X 



ACK 



DATA T 
X 



DATA T 
X 



EOT 



Receiving Station 



ACK 




DATA T 
X 



S E 
T T 
X X 



ACK 




System/3 Software/Adapter 



Line initialization 
(automatic) 



*Output to BSCfile 
(automatic acknowledge) 



Input conversational reply 
(automatic acknowledge) 



*Output to BSC file 
(automatic acknowledge) 



*End of job 
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LINE CONDITION-SYSTEM/3 RESPONSES 
Data Mode, System/3 Transmitting 



System/3 



Receiving Station 



System/3 Software/Adapter 



Data 



ENQ 



-V 



TTD 



Data 






Datal 



Datal 



Data2 



ENQ 
Data2 

— V- 



WACK 



ACK 



NAK 



ACK 



NAK 



ACK 



-V 






X 



ACKO (wrong ACK) 



ACKO (wrong ACK) 



ACK1 






'Output from BSC f ile 
(automatic acknowledge) 

System/3 recovery (automatic) 



*Output from BSC file 
(automatic acknowledge) 



System/3 recovery (automatic) 



*Output from BSC file 



System/3 recovery (automatic) 



Output from BSC file 



System/3 recovery (automatic) 
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Data Mode, System/3 Transmitting (continued) 
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System/3 



Data3 



ENQ 



Data3 






Data 



E 

Data T 

X 



EOT 



Receiving Station 



Time-out 



ACK 



ACK 



-4- 



RVI 



ACK or RVI 



ENQ 



System/3 permanent error condition while in transmit mode 



TTD 



EOT or DLE EOT 



NAK 



Data 



EOT or DLE EOT 



System/3 Software/Adapter 



'Output from BSC file 



System/3 recovery (automatic) 



Output from BSC file 
Sets System/3 record available indicator 

*lnput to BSC file 



*Causes error indicator set if assigned for 
BSC file, otherwise halts. 



'Output from BSC file 

* Causes error indicator set if assigned for 
BSC file, otherwise halts. 



J 
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Data Mode, System/3 Receiving 



114 



System/3 


Transmitting Station 


System/3 Software/Adapter 




-^" TTD 


*lnput from BSC f ile 
(automatic acknowledge) 


NAK ^ 








^f^ Data 


System/3 recovery (automatic) 


ACK .^ 


A 




r X 


f^ . 




^^ Data " 


'Input from BSC file 


WACK HH^ 








-^i—ENQ 


System/3 recovery (automatic) 


ACK M^ 


A 




\ 


I 


V 


V 

■^i" Datal 


*lnput from BSC file 




Time-out 






^^^ENQ 


System/3 recovery (automatic) 


ACK M^ 


-^^ Datal 




ACK, ^ 


A 




^ 


l 


V 


-^m Data2 ^ 


*lnput from BSC file 


NAK Hi^ 








•^^ Data2 


System/3 recovery (automatic) 


ACK a^- 






System/3 permanent error condition while in receive mode 




■^^■i Data 


*lnput from BSC file 


EOTor DLE EOT"^- 




*Causes error indicator set if assigned 
for BSC file, otherwise halts. 




•^mTTD 


*Causes error indicator set if assigned 
for BSC file, otherwise halts. 


NAK ^^ 


•^IH EOTor DLE EOT 





Glossary 



This glossary contains some terms that are used in this 
manual. Data processing and other communications terms 
are defined in IBM Data Processing Glossary. GC20-1699. 

addressing: A request from the control station to a 
tributary station to receive data. 

autoanswer: A machine feature that allows a called station 
to respond automatically to a call it receives over a switched 

line. 

baud: A unit of measuring the number of data characters 
sent on a BSCA line in a given time. 

binary synchronous communication: A flexible form of 
liiie control which provides a set of rules for communica- 
tion between two devices. 

called station: A station that accepts calls. 

calling station: The station from which a call originates. 

central station: See control station. 

clocking: ,4 procedure to control the number of data bits 
sent on a BSCA line in a given time. 

control station: The primary or controlling computer in a 
multipoint telecommunications configuration. It controls 
the sending and receiving of data. 

conversational file: A BSC file that allows receiving or 
sending data characters as an acknowledgment instead 
of the ACKO or ACKI character. 

data link: The communications hnes, modems (data sets), 
stations, terminals, and other communications equipment 
used for the transmission of data between stations. 

data link control characters: The control characters used 
by the data link and the control station to notify each 
other of ihcu" status and the status of the data sent or 
received. 



data link message: Data sent through BSCA using either 
EBCDIC or ASCII code. 

data mode: A time at which the BSCA is transmitting or 
receiving characters on the line. 

data set: See modem. 

disconnect timeout: An indication that the BSCA station 
you were communicating with has gone on hook or hung up. 

EBCDIC transparency: A provision that allows BSCA to 
send and receive messages containing any or all of the 256 
character combinations in the EBCDIC code, including 
data link control characters. 

error history file: A push-down stack of the last BSCA 
errors that have occurred. 

full duplex: A BSCA network that allows for simultaneous 
transmission and reception of data. 

half duplex: A two- or four-wire BSCA network that 
provides for data to be sent in only one direction at a 
given time. 

half rate: A modem feature that provides for transmitting 
or receiving data at one-half the normal rate. 

host: See control station. 

intermediate block check (ITB): A provision that allows 
for parity checking on each logical record rather than the 
total buffer when large buffers of data are received. 

line control characters: See data link control characters. 

manual answer: The machine operator makes the data 
set ready. 

manual dial: Dialing is performed by the machine operator. 

master: The BSCA station that is transmitting. 
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modem: A hardware box used to connect the BSC 
adapter to the BSC Hne. 

monitor mode: A time during which the BSC adapter is 
looking for synclironization characters. 

multidropped terminal: See tributary station. 

multipoint data link: More than two stations on a common 
transmission line or communication facility. Each station 
has the abihty to monitor the transmission line at all times 
for activity or data that may be directed to it. 

nonswitched line: A communication link between a remote 
station and computer that does not have to be established 
by dialing. 

op end interrupt: A hardware-generated interrupt used to 
indicate the completion of the software-initiated BSCA 
input/output operations. 

point-to-point data link: A communications facility that 
connects a single remote station to the computer. 

polling: A request from the control station to a tributary 
station to transmit data. Once the tributary station has 
accepted the invitation, through recognition of its polling 
characters sent by the control station, the remote station 
may use the line to send data. 

receive timeout: An indication that no data has been 
received by this BSC adapter in a given time. 

receive initial: A software command to allow the BSC 
adapter to receive synchronization characters. 

receive mode: A time during which the BSC adapter looks 
for synchronization characters and then stores the data 
characters in main storage. 

remote terminals: Interconnected equipment at a remote 
location having either input or output capabilities or both. 

reverse interrupt: A method of sending data records from 
one BSCA station to another station before receiving 
end-of-file indication from the other station. 

slave: The BSCA station that is receiving. 

standby line: A modem feature that allows a point-to- 
point leased line modem to also function on a point-to- 
point switched line. 



station: Any of the computers, terminals, or devices that 
use the communication facilities. 

switched tine: A communication line in which the connec- 
tion between the computer and a remote station is 
established by diahng. 

transparency: See EBCDIC transparency. 

transparent mode: A BSC adapter mode initiated by the 
sequence DLE STX. 

tributary station: A secondary or noncontroUing device in 
a multipoint telecommunications configuration. 

wrap test: A diagnostic procedure that transmits a specific 
character pattern to or through the modem in a loop and 
then compares the character pattern received to what was 
transmitted. It is used when unrecoverable BSCA hardware 
errors occur. 
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